Techmap.io Job Posting RSS Feed API

{ "openapi": "3.0.0", "externalDocs": { "description": "API Documentation (OpenAPI)", "url": "https://api.techmap.io/rss-api" }, "info": { "title": "Techmap's Job Postings RSS Feed", "version": "1.0.0", "contact": { "name": "API Support", "url": "https://jobdatafeeds.com/contact-us", "email": "data@techmap.io" }, "x-logo": { "url": "https://api.techmap.io/favicon/android-chrome-512x512.png", "altText": "API Logo", "href": "/rss-api" }, "description": "\n#### Changelog\n\n- **2025-03-17 (v1.0)**: Published **first version**.\n\n---\n\n### **Introduction**\n\nThis API provides access to full job postings in long **RSS format**, sourced through web crawling and scraping from various platforms, with jobs available for up to three months.\n\nJob postings are collected directly from a diverse range of sources, including:\n\n-\tTechmap’s Web Crawlers\n-\tATS Career Pages (e.g., Workday, Personio, JazzHR)\n-\tJob Boards (e.g., LinkedIn, Monster, Dice)\n-\tJob Aggregators (e.g., Indeed, Glassdoor, Xing)\n-\tGovernment Employment Offices (e.g., German Arbeitsagentur)\n\nThis API enables seamless integration of job postings from multiple sources into your job board, career site, or recruitment platform, making it ideal for backfilling job listings with fresh, relevant data.\n\n\n### Boolean Queries\n\nMost query parameters in the API support flexible Boolean queries, enabling precise filtering of job postings using multiple keywords, keyphrases, and logical operators.\nBelow are the supported query types:\n\n- **Should Searches (OR):**\n Keywords separated by a comma will match at least one keyword.\n Example: `title=java,developer`\n Matches jobs with either \"java\" or \"developer\" in the title.\n\n- **Must Searches (AND):**\n Keywords with an encoded `+` sign (`%2B` in the URL) must be present.\n Example: `title=%2bjava,%2bdeveloper`\n Matches jobs with both \"java\" and \"developer\" in the title.\n\n- **Must-Not Searches (NOT):**\n Keywords with a `-` sign before are excluded.\n Example: `title=%2bjava,-mysql`\n Matches jobs with \"java\" but not \"mysql\" in the title.\n\n- **Keyphrase Searches:**\n Words separated with spaces in double quotes count as one keyword / keyphrase.\n Example: `city=\"New York\"`\n Matches jobs in \"New York\".\n\n\n### Notes\n- **Parameter Combinations**: You can combine most parameters, but some combinations may not work together. For example, a geo bounding box cannot be used together with a geo distance search.\n- **Field Availability**: Not all fields are populated for every job posting. Commonly missing fields include `state`, `postCode`, or `department`.\n- **Authentication**: If your job board admin page only allows setting a URL, you must include the **authentication key as a parameter**, not a header.\n\n\n### Examples\n\n- **Jobs in Germany:**\n ```curl\n curl -X GET \"https://job-postings-rss-feed.p.rapidapi.com/api/rss/v1/jobs_full?countryCode=de&rapidapi-key=YOUR_KEY\" -H \"Authorization: Bearer \"\n ```\n\n " }, "components": { "parameters": { "FieldParam": { "name": "field", "in": "query", "description": "A field name used in a query as a parameter", "required": true, "schema": { "type": "string" } }, "PageSize": { "name": "pageSize", "in": "query", "description": "The number of job postings per request with an absolute max of 1000. Max and default depends on subscription plan.", "required": false, "schema": { "type": "integer", "minimum": 1 } }, "PaginationPage": { "name": "page", "in": "query", "description": "The page of the paginated search results starting at 1. Defaults to 1 if not stated.", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, "DateCreated": { "name": "dateCreated", "in": "query", "description": "The day the job posting was created / posted on using the format `YYYY-MM-DD` or `YYYY-MM`. If empty, the current day minus 2 days is used.", "required": false, "schema": { "type": "string", "format": "date", "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$" } }, "IsDirect": { "name": "isDirect", "in": "query", "description": "A flag indicating if the job posting URL links directly to the company's website or ATS career page.", "required": false, "schema": { "type": "string", "format": "boolean" } }, "IsActive": { "name": "isActive", "in": "query", "description": "A flag indicating if the job posting has a dateActive not yet reached.", "required": false, "schema": { "type": "string", "format": "boolean" } }, "IsRecruiter": { "name": "isRecruiter", "in": "query", "description": "A flag indicating if the job posting was posted by a recruiting firm.", "required": false, "schema": { "type": "string", "format": "boolean" } }, "CountryCode": { "name": "countryCode", "in": "query", "description": "The country the job is located in described by a 2-letter country code from ISO 3166-1 alpha-2. Internally, we lower-case the countryCode and convert 'gb' into 'uk' and 'el' into 'gr' - you can use both spellings.", "required": false, "schema": { "type": "string", "format": "ISO 3166-1 alpha-2", "example": "us" } }, "LanguageCode": { "name": "language", "in": "query", "description": "The language the job posting is written in described by a 2-letter language code from ISO 639-1 such as 'en', 'de' or 'zh'.", "required": false, "schema": { "type": "string", "format": "ISO 639-1" } }, "LocaleCode": { "name": "locale", "in": "query", "description": "The locale the job posting is written for described by a language and country code.", "required": false, "schema": { "type": "string", "pattern": "^[a-z]{2}_[A-Z]{2}$" } }, "Title": { "name": "title", "in": "query", "description": "Free-text search within the title of the job postings.", "required": false, "schema": { "type": "string" } }, "Skills": { "in": "query", "name": "skills", "required": false, "schema": { "type": "string" }, "description": "The skills, keywords, or tags associated with the job posting." }, "Company": { "in": "query", "name": "company", "required": false, "schema": { "type": "string" }, "description": "The company that posted the job posting (can be a recruiting firm)." }, "hasSalary": { "in": "query", "name": "hasSalary", "required": false, "schema": { "type": "string", "format": "boolean", "example": "true" }, "description": "A flag indicating if the job posting contains salary information.", "x-group": "Salary Parameters" }, "minSalary": { "in": "query", "name": "minSalary", "required": false, "schema": { "type": "number" }, "description": "The minimum salary of the job posting. Can be yearly, monthly, or hourly and any currency.", "x-group": "Salary Parameters" }, "Occupation": { "in": "query", "name": "occupation", "required": false, "schema": { "type": "string" }, "description": "The occupation type extracted from the job title reduced to a stem form incl. several synonyms. For example: programmer, executive, manager, engineer, nurse, etc." }, "Department": { "in": "query", "name": "department", "required": false, "schema": { "type": "string" }, "description": "The department extracted from the job title such as, finance, it, hr, sales, etc." }, "Industry": { "in": "query", "name": "industry", "required": false, "schema": { "type": "string" }, "description": "The industry extracted from the job posting or categorization in the job board, such as advertising, agriculture, it, healthcare, etc." }, "PostCode": { "in": "query", "name": "postCode", "required": false, "schema": { "type": "string" }, "description": "The postal / zip code the workplace is located in, extracted from the job posting or geo-location." }, "City": { "in": "query", "name": "city", "required": false, "schema": { "type": "string" }, "description": "The city the workplace is located in, extracted from the job posting or geo-location." }, "WorkType": { "in": "query", "name": "workType", "required": false, "schema": { "type": "string" }, "description": "The type of work duration extracted from the job posting such as fulltime, parttime, flextime, etc." }, "State": { "in": "query", "name": "state", "required": false, "schema": { "type": "string" }, "description": "The state the workplace is located in, extracted from the job posting or geo-location." }, "WorkPlace": { "in": "query", "name": "workPlace", "required": false, "schema": { "type": "string" }, "description": "The workplace of the job, extracted from the job posting such as remote, hybrid, onsite, field, offshore, etc." }, "ContractType": { "in": "query", "name": "contractType", "required": false, "schema": { "type": "string" }, "description": "The type of employment contract extracted from the job posting such as permanent, temporary, internship, etc." }, "Timezone": { "in": "query", "name": "timezone", "required": false, "schema": { "type": "string" }, "description": "The timezone the job is located in such as CET, PST, or UTC" }, "TimezoneOffset": { "in": "query", "name": "timezoneOffset", "required": false, "schema": { "type": "integer", "minimum": -12, "maximum": 12 }, "description": "The numeric offset of the timezone from UTC." }, "TimezoneMin": { "name": "timezoneMin", "in": "query", "required": false, "schema": { "type": "integer", "minimum": -12, "maximum": 12 }, "description": "The minimum numeric offset of the timezone from UTC. Requires a 'timezoneMax' value greater than 'timezoneMin' to search in a timezone range." }, "TimezoneMax": { "name": "timezoneMax", "in": "query", "required": false, "schema": { "type": "integer", "minimum": -12, "maximum": 12 }, "description": "The maximum numeric offset of the timezone from UTC. Must be larger than 'timezoneMin' to search in a timezone range." }, "GeoPointLat": { "in": "query", "name": "geoPointLat", "required": false, "schema": { "type": "number", "format": "number", "minimum": -90, "maximum": 90 }, "description": "The geographic latitude of a GeoPoint used in a distance search." }, "GeoPointLng": { "in": "query", "name": "geoPointLng", "required": false, "schema": { "type": "number", "format": "number", "minimum": -180, "maximum": 180 }, "description": "The geographic longitude of a GeoPoint used in a distance search." }, "GeoDistance": { "in": "query", "name": "geoDistance", "required": false, "schema": { "type": "string", "pattern": "^[0-9]+(km|mi)$", "minimum": 0, "maximum": 200 }, "description": "The distance from a GeoPoint specified with 'geoPointLat' and 'geoPointLng'." }, "GeoTopLeftLat": { "in": "query", "name": "geoTopLeftLat", "required": false, "schema": { "type": "number", "format": "number", "minimum": -90, "maximum": 90 }, "description": "The geographic latitude of the top left GeoPoint in a bounding box search." }, "GeoTopLeftLng": { "in": "query", "name": "geoTopLeftLng", "required": false, "schema": { "type": "number", "minimum": -180, "maximum": 180 }, "description": "The geographic longitude of the top left GeoPoint in a bounding box search." }, "GeoBottomRightLat": { "in": "query", "name": "geoBottomRightLat", "required": false, "schema": { "type": "number", "format": "number", "minimum": -90, "maximum": 90 }, "description": "The geographic latitude of the bottom right GeoPoint in a bounding box search." }, "GeoBottomRightLng": { "in": "query", "name": "geoBottomRightLng", "required": false, "schema": { "type": "number", "minimum": -180, "maximum": 180 }, "description": "The geographic longitude of the bottom right GeoPoint in a bounding box search." }, "Portal": { "in": "query", "name": "portal", "required": false, "description": "The portal the job postings originated from.", "schema": { "type": "string" } }, "Source": { "in": "query", "name": "source", "required": false, "schema": { "type": "string" }, "description": "The specific source with countrycode the job postings originated from such as careerjet, monster, linkedin, techmap, etc." } }, "schemas": { "GetSearchResponse": { "format": "application/rss+xml", "type": "object", "description": "RSS feed with job postings for a specific query.", "properties": { "title": { "description": "API Title", "type": "string", "example": "Techmap.io Job Posting RSS Feed API" }, "link": { "description": "The link with query parameters received by the API.", "type": "string", "example": "https://job-postings-rss-feed.p.rapidapi.com/api/rss/v1/jobs_full?workPlace=remote" }, "description": { "description": "API endpoint summary", "type": "string", "example": "Techmap.io's Job Posting API in RSS 2.0 Feed format based on a search query." }, "pubDate": { "description": "DateTime the RSS feed was published / read as an UTC string.", "type": "string", "example": "Mon, 17 Mar 2025 08:53:04 GMT" }, "docs": { "description": "API Documentation link", "type": "string", "example": "https://api.techmap.io/rss-doc" }, "webMaster": { "description": "Contact email of the webmaster of the RSS feed.", "type": "string", "example": "data@techmap.io" }, "ttl": { "description": "Time-to-live of the RSS feed in minutes.", "type": "string", "example": "1440" }, "contact": { "description": "API Contact info", "type": "string", "example": "Please contact us at data@techmap.io" }, "apiVersion": { "description": "API Version", "type": "string", "example": "1.0.0" }, "page": { "description": "The current page number of the results in the pagination starting at 1", "type": "integer", "example": "2" }, "pageSize": { "description": "The max. number of job postings displayed per page", "type": "integer", "example": "10" }, "totalCount": { "description": "The total number of job postings matching the search criteria.", "type": "integer", "example": "180725" }, "query": { "description": "The search query we constructed and used to count the job postings.", "type": "object", "$ref": "#/components/schemas/Query" }, "item": { "description": "Job Postings with their data.", "items": { "$ref": "#/components/schemas/Item" } } } }, "Query": { "type": "object", "description": "Aggregation used on OpenSearch to calculate distinct counts.", "properties": { "query": { "properties": { "bool": { "properties": { "must": { "description": "Parameter queries that must exists in the job posting.", "type": "array" }, "must_not": { "description": "Parameter queries that must NOT exists in the job posting.", "type": "array" }, "should": { "description": "Parameter queries that should exists in the job posting. At least one must match.", "type": "array" } } } } } } }, "Item": { "type": "object", "properties": { "title": { "type": "string", "description": "The job title or position of the job posting.", "example": "Developer III (Java) - Cartage, IS Operational Experience" }, "description": { "type": "string", "description": "The full description of the job posting in text / markdown.", "example": "The Information Technology department at Penguin Random House (PRH) is looking for a Developer to join their team. This developer will report to ..." }, "pubDate": { "description": "DateTime the Job Posting was published / read as an UTC string.", "type": "string", "example": "Sat, 15 Mar 2025 00:00:00 GMT" }, "link": { "description": "The external link to the job posting.", "type": "string", "format": "uri", "example": "https://www.careerjet.com/jobad/use0becff9b4b2a7edfd7457b920cf8079" }, "guid": { "description": "Defines a unique identifier for the item. Same as link.", "type": "string", "example": "https://www.careerjet.com/jobad/use0becff9b4b2a7edfd7457b920cf8079" }, "category": { "type": "string", "description": "The category the job posting falls into.", "example": "Network Engineer" }, "city": { "type": "string", "description": "The city of the job location.", "example": "Seattle" }, "state": { "type": "string", "description": "The state of the job location.", "example": "Washington" }, "country": { "type": "string", "description": "The full country name or country code.", "example": "United States" }, "company": { "type": "string", "description": "The company placing the job ad.", "example": "Microsoft" }, "company_url": { "description": "Link to the company website.", "type": "string", "format": "uri", "example": "https://www.microsoft.com" }, "company_logo": { "description": "Link to the company's logo used in the job ad.", "type": "string", "format": "uri", "example": "https://s3.eu-central-1.amazonaws.com/images.techmap.io/dice_us-9340a448-31ef-57db-9452-d55b0f3675cf-logo.png" }, "apply_link": { "description": "The external link to a special application page of the job posting.", "type": "string", "format": "uri", "example": "https://www.careerjet.com/jobad/use0becff9b4b2a7edfd7457b920cf8079" }, "salary": { "type": "number", "format": "number", "description": "The minimum salary stated in the posting. Can be yearly, monthly, or hourly and any currency (but is probably the local currency official in use).", "example": 110000 }, "workType": { "description": "The type of work for the job.", "type": "array", "items": { "type": "string" }, "example": [ "FullTime" ] }, "contractType": { "description": "The type of contract for the job.", "type": "array", "items": { "type": "string" }, "example": [ "Permanent" ] }, "industry": { "type": "string", "description": "The industry or field to which the job belongs.", "example": "Construction" }, "careerLevel": { "description": "The career level necessary for the job.", "type": "array", "items": { "type": "string" }, "example": [ "Senior" ] }, "workPlace": { "description": "The work place for the job.", "type": "array", "items": { "type": "string" }, "example": [ "Onsite", "Hybrid", "Remote" ] }, "skills": { "type": "array", "description": "A list of skills associated with the job.", "items": { "type": "string" }, "example": [ "Java", "Intellij", "Cloud computing" ] }, "department": { "type": "string", "description": "The department in the company.", "example": "IT" }, "occupation": { "type": "string", "description": "The job title or position.", "example": "Programmer" } } }, "Response400": { "description": "Bad Request - e.g., parameter value could not be parsed.", "type": "object", "example": { "error": { "root_cause": [ { "type": "parse_exception", "reason": "cannot parse empty date" }, { "type": "parse_exception", "reason": "cannot parse empty date" } ], "type": "search_phase_execution_exception", "reason": "all shards failed", "phase": "query", "grouped": true, "failed_shards": [ { "shard": 0, "index": "jobs_v6", "node": "XE_he1b4TfehZ4QHFGUmGQ", "reason": { "type": "parse_exception", "reason": "cannot parse empty date" } }, { "shard": 0, "index": "jobs_v7", "node": "XE_he1b4TfehZ4QHFGUmGQ", "reason": { "type": "parse_exception", "reason": "cannot parse empty date" } } ] }, "status": 400 } }, "Response403": { "description": "Forbidden Request - e.g., wrong supscription plan", "type": "object", "properties": { "message": { "description": "The error message.", "type": "string", "nullable": false } }, "example": { "message": "Forbidden request to the API. BASIC subscription plan is NOT sufficient." } }, "Response405": { "description": "Method Not Allowed - e.g., using POST not GET", "type": "object", "properties": { "message": { "description": "The error message.", "type": "string", "nullable": false } }, "example": { "message": "Method 'POST' not Allowed! Please use one of: GET" } }, "Response4xx": { "description": "Client Error - i.e., you made a mistake.", "type": "object", "properties": { "message": { "description": "The error message.", "type": "string", "nullable": false } }, "example": { "message": "... The error message ..." } }, "Response500": { "description": "Internal Server Error (more info in return value)", "type": "object", "properties": { "message": { "description": "The error message.", "type": "string", "nullable": false } }, "example": { "message": "Problem with GET: NullPointerException" } }, "Response503": { "description": "Service Unavailable - due to problems with our backend", "type": "object", "properties": { "message": { "description": "The error message.", "type": "string", "nullable": false } }, "example": { "message": "Problems connecting to our Backend - please try again later!" } }, "Response509": { "description": "Bandwidth Limit Exceeded - too much data transmitted", "type": "object", "properties": { "message": { "description": "The error message.", "type": "string", "nullable": false } }, "example": { "message": "Bandwidth Limit Exceeded: Too much data to transmit - payload is over 6MB (AWS Lambda Payload Limit)" } }, "Response5xx": { "description": "Server Error - i.e., we made a mistake.", "type": "object", "properties": { "message": { "description": "The error message.", "type": "string", "nullable": false } }, "example": { "message": "... The error message ..." } } } }, "servers": [ { "url": "https://api-techmap-io.vercel.app/", "description": "RapidAPI API server access" } ], "paths": { "/api/rss/v1/jobs_full": { "get": { "operationId": "jobs_full", "summary": "Get Full Jobs", "description": "This endpoint returns an **RSS feed** containing job postings, including **full job descriptions**, based on the specified search query. Results can be paginated for efficient data retrieval.

The RSS/XML data can be easily customized to meet specific needs and seamlessly integrated into a job board to backfill it with fresh, relevant job postings.", "externalDocs": { "description": "API Documentation (OpenAPI)", "url": "https://api.techmap.io/rss-api#operation/jobs_full" }, "parameters": [ { "$ref": "#/components/parameters/DateCreated" }, { "$ref": "#/components/parameters/CountryCode" }, { "$ref": "#/components/parameters/City" }, { "$ref": "#/components/parameters/Title" }, { "$ref": "#/components/parameters/Skills" }, { "$ref": "#/components/parameters/LanguageCode" }, { "$ref": "#/components/parameters/WorkPlace" }, { "$ref": "#/components/parameters/ContractType" }, { "$ref": "#/components/parameters/WorkType" }, { "$ref": "#/components/parameters/hasSalary" }, { "$ref": "#/components/parameters/minSalary" }, { "$ref": "#/components/parameters/IsDirect" }, { "$ref": "#/components/parameters/IsRecruiter" }, { "$ref": "#/components/parameters/Industry" }, { "$ref": "#/components/parameters/Company" }, { "$ref": "#/components/parameters/Occupation" }, { "$ref": "#/components/parameters/Timezone" }, { "$ref": "#/components/parameters/TimezoneOffset" }, { "$ref": "#/components/parameters/TimezoneMin" }, { "$ref": "#/components/parameters/TimezoneMax" }, { "$ref": "#/components/parameters/GeoPointLat" }, { "$ref": "#/components/parameters/GeoPointLng" }, { "$ref": "#/components/parameters/GeoDistance" }, { "$ref": "#/components/parameters/GeoTopLeftLat" }, { "$ref": "#/components/parameters/GeoTopLeftLng" }, { "$ref": "#/components/parameters/GeoBottomRightLat" }, { "$ref": "#/components/parameters/GeoBottomRightLng" }, { "$ref": "#/components/parameters/PaginationPage" }, { "$ref": "#/components/parameters/PageSize" } ], "responses": { "200": { "description": "Success - indicating a correct query execution with results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetSearchResponse" } }, "application/rss+xml": { "schema": { "$ref": "#/components/schemas/GetSearchResponse" }, "examples": { "xml": { "summary": "A sample RSS+XML response", "value": " Techmap.io Job Posting RSS Feed API localhost:3001/api/rss/v1/jobs_full?workPlace=remote Techmap.io´s Job Posting API in RSS 2.0 Feed format based on a search query. Mon, 17 Mar 2025 11:42:13 GMT https://api.techmap.io/rss-doc data@techmap.io 1440 Do you have any feedback for us? Missing fields? Unclear docu? Other improvement suggetions? Please contact us at data@techmap.io 1.0.0 1 10 2002 2025-03-15T00:00:00.000Z 2025-03-15T23:59:59.999Z remote Condition Monitoring Engineer **About us**Nanoprecise Sci Corp is an ... Sat, 15 Mar 2025 00:00:00 GMT https://ca.jora.com/job/ondition-Monitoring-Engineer-a856799e2cad51d16b83025003e3fb29 https://ca.jora.com/job/Condition-Monitoring-Engineer-a856799e2cad51d16b83025003e3fb29 Monitoring Engineer Canada, Canada Kanata ON Canada Nanoprecise https://nanoprecise.io Engineering Remote Cat, Io Monitoring Engineer ..." } } } } }, "400": { "description": "Bad Request - e.g., parameter value could not be parsed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response400" } } } }, "405": { "description": "Method Not Allowed - e.g., using POST not GET", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response405" } } } }, "500": { "description": "Internal Server Error (more info in return value)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response500" } } } }, "503": { "description": "Service Unavailable - due to problems with our backend", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response503" } } } }, "509": { "description": "Bandwidth Limit Exceeded - too much data transmitted", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response509" } } } } } } } }, "tags": [] }