Job Posting API Documentation

Table of Contents

1. API Overview

Techmap collects job postings from 200+ sources - ATS career pages, job boards, aggregators, and employment offices - and makes them available through two APIs and daily bulk feeds. The Daily International Job Postings API covers the last 3 months and returns JSON by default but can be set to return CSV, RSS, ATOM, XML, or Parquet output instead. The Job Postings RSS API serves job boards that consume RSS feeds directly. For bulk access, Job Data Feeds provide gzip-compressed JSON-Lines files per country per day.

Both APIs are hosted on RapidAPI and share the same query parameter structure. The full OpenAPI definitions are at api.techmap.io/jobs-api (JSON API) and api.techmap.io/rss-api (RSS API).

Common developer use cases

• Job board backfilling: Query /search with countryCode, industry, or job title filters and isDuplicate=false to backfill new job postings into your job board database.
• Hiring trend analysis: Use /count with a dateCreated month range to build month-over-month hiring volume time series per country or industry. For time series longer than 3 months, use the historical datasets (available from Jan. 2020).
• Company monitoring: Filter by company=Acme and isDirect=true to track open roles at specific companies.
• Skill demand mapping: Query /count with skills and countryCode to measure demand for specific technologies per market.
• Geo-targeted feeds: Use geoPointLat, geoPointLng, and geoDistance to retrieve postings within a radius of a specific location.

1.1 Which Product is Right for You?

Four access options are available depending on your use case:

1.2 How to Subscribe

Both APIs are hosted on RapidAPI. Sign up for a free account, subscribe to the Basic plan, and copy your API key. The Job Postings API accepts the key in the X-RapidAPI-Key: <your-api-key> header (optionally with X-RapidAPI-Host) or as the URL parameter rapidapi-key=<your-api-key>. The RSS API is called with the URL parameter rapidapi-key only, so the feed URL works in any feed reader or job board importer without custom headers. Step-by-step guide with curl, Python, and JavaScript: API Quickstart.

1. Create a RapidAPI account: rapidapi.com/auth/sign-up
2. Subscribe to the Basic plan: The Basic plan of the Job Postings API is free and includes 100 requests (1000 job postings) per month. The Basic plan of the RSS API is free and includes 100 requests (1000 job postings, 10 per response, no pagination) per month. Requests above the included quota are not blocked but billed as overage - see Errors & billing.
3. Copy your API key: Found in your RapidAPI dashboard after subscribing.
4. Make your first request: Use the RapidAPI playground which generates ready-to-use code snippets in Python, JavaScript, Java, C#, and more (see Job Postings API Playground or RSS API Playground) - or send a direct HTTP request.

2. Endpoints

Full OpenAPI definitions: Daily International Job Postings and Job Postings RSS.

Daily International Job Postings API Endpoints

(base URL: https://daily-international-job-postings.p.rapidapi.com):

• GET /api/v2/jobs/search - Returns up to 10 job postings per page matching the query. Available on all plans.
• GET /api/v2/jobs/count - Returns the total count matching the query without returning job data. Useful for analytics and pagination planning. Available on all plans.
• GET /api/v2/meta/jobs/distinct - Returns distinct values and counts for a selected field (e.g., industry, workPlace, careerLevel) over the last 30 days. Available on PRO, ULTRA, and MEGA plans.
• GET /api/v2/meta/jobs/statistics - Returns the count and percentage of job postings per value of a field (top 100 values) for the last 30 days. Available on PRO, ULTRA, and MEGA plans.

Job Postings RSS API Endpoints

(base URL: https://job-postings-rss-feed.p.rapidapi.com):

• GET /api/rss/v1/jobs_full - Returns job postings in RSS 2.0 (XML) format, including full description and metadata. Postings per response depend on the plan: 10 (Basic, Pro), 100 (Ultra), 1000 (Mega); pagination from Pro on. Example feed URL with the key as URL parameter: https://job-postings-rss-feed.p.rapidapi.com/api/rss/v1/jobs_full?countryCode=us&title=developer&rapidapi-key=<your-api-key>

2.1 Query Parameters

All parameters are optional. Text parameters support boolean operators (see below). Parameters marked search only are not available on /count.

2.2 Boolean Operators

Most text parameters support boolean operators for precise filtering:

• OR (default): Comma-separated values match any. title=java,python returns jobs with "java" or "python" in the title.
• AND (must include): Prefix with %2B (an URL-encoded +). skills=%2Bjava,%2Bpython requires both.
• NOT (must exclude): Prefix with -. title=data,%2Bengineer,-scientist matches "data engineer" but not "data scientist".
• Exact phrase: Wrap in double quotes ("). title="data engineer" matches the exact phrase.

Example cURL queries:

• Remote jobs in core US timezones (UTC-8 to UTC-5):
  curl -X GET "https://daily-international-job-postings.p.rapidapi.com/api/v2/jobs/count?workPlace=remote&timezoneMin=-8&timezoneMax=-5" -H "X-RapidAPI-Key: <your-api-key>"
• Python or Spark jobs in Germany:
  curl -X GET "https://daily-international-job-postings.p.rapidapi.com/api/v2/jobs/count?countryCode=de&skills=Python,Spark" -H "X-RapidAPI-Key: <your-api-key>"
• Jobs within 50 miles of San Francisco:
  curl -X GET "https://daily-international-job-postings.p.rapidapi.com/api/v2/jobs/count?geoPointLat=37.757&geoPointLng=-122.449&geoDistance=50mi" -H "X-RapidAPI-Key: <your-api-key>"

2.3 Pagination

The /search endpoint returns 10 job postings per page. Use totalCount from the response to determine how many pages exist. Rate limits per plan and the quota headers: Pagination, rate limits & quota.

Page-based pagination

Use the page parameter (starting at 1) for result sets up to approximately 10000 records. If you expect more pages, use cursor-based pagination.

Cursor-based pagination

For large result sets (e.g. all jobs in the US for a given month), pass cursor=true on the first request. The response includes a nextCursor field when more results exist. Pass that value as cursor in the next request. Stop when nextCursor is absent from the response. Cursor-based pagination cannot be combined with the page parameter. However, think about using the data feeds if you want to access many job postings on a regular schedule - it might be the easier and cheaper option.

2.4 Code Examples

The RapidAPI playground generates ready-to-use code snippets in Python, JavaScript, Java, C#, PHP, and more. Open the API playground page on RapidAPI (see Job Postings API Playground or RSS API Playground), configure your query parameters, and copy the generated snippet.

Page-based pagination (Python)

Fetch all jobs from Germany for a given month. Use for result sets up to ~10000 records.

import requests

API_URL = "https://daily-international-job-postings.p.rapidapi.com/api/v2/jobs"
HEADERS = {"X-RapidAPI-Key": "<your-api-key>", "X-RapidAPI-Host": "daily-international-job-postings.p.rapidapi.com"}

params = {
    "countryCode": "de",
    "dateCreated": "2026-09",
    "isDuplicate": "false",
}
page, all_jobs = 1, []

while True:
    resp = requests.get(f"{API_URL}/search", headers=HEADERS, params={**params, "page": page})
    resp.raise_for_status()
    data = resp.json()
    batch = data.get("result", [])
    all_jobs.extend(batch)
    if len(all_jobs) >= data["totalCount"] or not batch:
        break
    page += 1

print(f"Fetched {len(all_jobs)} jobs")

Cursor-based pagination (Python)

Fetch all jobs from the US for a given month. Use for large result sets (>10000 records).

import requests

API_URL = "https://daily-international-job-postings.p.rapidapi.com/api/v2/jobs"
HEADERS = {"X-RapidAPI-Key": "<your-api-key>", "X-RapidAPI-Host": "daily-international-job-postings.p.rapidapi.com"}

params = {
    "countryCode": "us",
    "dateCreated": "2026-09",
    "isDuplicate": "false",
}
cursor, all_jobs = "true", []

while cursor:
    resp = requests.get(f"{API_URL}/search", headers=HEADERS, params={**params, "cursor": cursor})
    resp.raise_for_status()
    data = resp.json()
    all_jobs.extend(data.get("result", []))
    cursor = data.get("nextCursor")  # None when no more results remain

print(f"Fetched {len(all_jobs)} jobs")

Count query for analytics (Python)

Get monthly job posting counts per country without fetching job data.

import requests

API_URL = "https://daily-international-job-postings.p.rapidapi.com/api/v2/jobs"
HEADERS = {"X-RapidAPI-Key": "<your-api-key>", "X-RapidAPI-Host": "daily-international-job-postings.p.rapidapi.com"}

months = ["2026-07", "2026-08", "2026-09"]
countries = ["de", "fr", "gb"]

for country in countries:
    for month in months:
        resp = requests.get(f"{API_URL}/count", headers=HEADERS, params={
            "countryCode": country,
            "dateCreated": month,
            "isDuplicate": "false",
        })
        data = resp.json()
        print(f"{country} {month}: {data.get('totalCount', 0)} jobs")

Search request (JavaScript)

Node.js 18+ or browser, using fetch.

const url = new URL("https://daily-international-job-postings.p.rapidapi.com/api/v2/jobs/search");
url.search = new URLSearchParams({ countryCode: "de", dateCreated: "2026-09", isDuplicate: "false" });

const response = await fetch(url, {
  headers: {
    "X-RapidAPI-Key": "<your-api-key>",
    "X-RapidAPI-Host": "daily-international-job-postings.p.rapidapi.com",
  },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const data = await response.json();
console.log(data.totalCount, data.result.length);

RSS feed (Python)

The RSS API takes the key as URL parameter, so the same URL also works in job board importers.

import feedparser  # pip install feedparser

url = ("https://job-postings-rss-feed.p.rapidapi.com/api/rss/v1/jobs_full"
       "?countryCode=us&title=developer&rapidapi-key=<your-api-key>")
feed = feedparser.parse(url)
for item in feed.entries:
    print(item.title, item.link)

2.5 Error Handling

Example 400 response body:

{ "message": "Problem getting documents for day '2026-13-01': Not a valid day or in wrong format 'YYYY-MM-DD'!" }

Example 403 response body:

{ "message": "Forbidden request to the API - this endpoint is not included in your plan. It is included from the Pro plan on.", "requiredPlan": "Pro", "pricingUrl": "https://rapidapi.com/techmap-io-techmap-io-default/api/daily-international-job-postings/pricing" }

All status codes with cause and solution, plus how overage works: Errors & billing.

3. Data Dictionary

All fields with type, example and how often they are filled: Field reference.

The full text of each job posting is in job.jsonLD.description as Markdown. The job.jsonLD object is a simple schema.org JobPosting representation and can be embedded directly in a webpage for structured data markup.

Response envelope fields

Top-level fields returned by /search:

Job posting fields (result[])

Each element in the result array contains these fields. Not all fields are populated for every posting - sparsely populated fields include state, postCode, department, workPlace, careerLevel, and salary fields.

The RSS API response follows the RSS 2.0 specification and includes: title, description, pubDate, link, guid, category, location, city, state, country, company, company_url, company_logo, workType, contractType, industry, careerLevel, workPlace, skills, department, and occupation.

3.1 Data Samples

Sample responses for download in JSON, CSV, RSS, Atom, XML and Parquet: Sample data.

JSON response example

The /search response follows the JSON ECMA-404 specification.

{
  "api": "Techmap.io Job Posting API",
  "apiVersion": "v2.6",
  "page": 1,
  "pageSize": 10,
  "totalCount": 1069346,
  "result": [
    {
      "occupation": "Functional Analyst",
      "dateActive": "2024-10-14T14:48:29.000Z",
      "city": "Cleveland",
      "timezone": "CST",
      "contractType": ["DirectEmployment"],
      "language": "en",
      "industry": "Transport",
      "isDuplicate": false,
      "isDuplicateOf": null,
      "isDirect": false,
      "isRecruiter": false,
      "hasSalary": false,
      "jsonLD": {
        "identifier": "66f4d794a315a1138e6bfac2",
        "validThrough": "2024-10-14T14:48:29.000Z",
        "employmentType": "Direct Employment",
        "@type": "JobPosting",
        "salaryCurrency": "USD",
        "description": "**Job Description:** ...",
        "industry": "Transport",
        "title": "SAP TM Functional Analyst",
        "@context": "https://schema.org",
        "url": "https://www.dice.com/job-detail/003170f7-bd59-45d5-a0cf-e4ef93c27419",
        "relevantOccupation": "Functional Analyst",
        "skills": ["Logistics", "SAP TM", "ABAP"],
        "hiringOrganization": {
          "@type": "Organization",
          "name": "Example Corp",
          "url": "https://example.com"
        },
        "jobLocation": {
          "address": {
            "addressCountry": "United States",
            "@type": "PostalAddress",
            "addressLocality": "Cleveland",
            "addressRegion": "TX"
          },
          "@type": "Place",
          "latitude": 30.33804,
          "longitude": -95.02362
        },
        "datePosted": "2024-09-15"
      },
      "source": "dice_us",
      "locale": "en_US",
      "geoPoint": { "lon": -95.02362, "lat": 30.33804 },
      "title": "SAP TM Functional Analyst",
      "skills": ["Logistics", "SAP TM", "ABAP"],
      "dateCreated": "2024-09-15T14:43:24.000Z",
      "timezoneOffset": -6,
      "countryCode": "us",
      "company": "Example Corp",
      "state": "TX",
      "portal": "dice",
      "workPlace": ["Onsite"],
      "careerLevel": ["N/A"],
      "workType": ["N/A"],
      "postCode": "77327"
    }
  ],
  "resultSizeInBytes": 59203
}

RSS response example

The /jobs_full endpoint returns RSS 2.0 format.

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
    <title>Techmap.io Job Posting RSS Feed API</title>
    <link>https://job-postings-rss-feed.p.rapidapi.com/api/rss/v1/jobs_full?dateCreated=2024-09&amp;countryCode=us</link>
    <description>Techmap.io Job Posting API in RSS 2.0 format.</description>
    <pubDate>Mon, 16 Sep 2024 08:59:01 GMT</pubDate>
    <ttl>1440</ttl>
    <page>1</page>
    <pageSize>10</pageSize>
    <totalCount>1069251</totalCount>
    <item>
      <title>Entry-Level Technician</title>
      <description>We are looking for ...</description>
      <pubDate>Sun, 15 Sep 2024 05:00:00 GMT</pubDate>
      <link>https://careers-example.icims.com/jobs/55300/job</link>
      <guid>https://careers-example.icims.com/jobs/55300/job</guid>
      <category>Technician</category>
      <city>Portland</city>
      <state>OR</state>
      <country>United States</country>
      <company>Example Company</company>
      <industry>Trade</industry>
      <careerLevel>Junior</careerLevel>
      <workPlace>Onsite</workPlace>
      <occupation>Technician</occupation>
    </item>
  </channel>
</rss>

4. References

• Daily International Job Postings API on RapidAPI
• Daily International Job Postings OpenAPI definition
• Job Postings RSS API on RapidAPI
• Job Postings RSS OpenAPI definition
• API Quickstart - first call with curl, Python, and JavaScript
• Errors & billing - status codes, plans, and overage
• Pagination, rate limits & quota
• Integrations - sync patterns, Postman collections, MCP server
• Field reference - all fields with coverage
• API changelog (RSS feed)
• llms.txt - API documentation for AI assistants
• Job Data Overview - field reference for data feeds and datasets
• Portal Explorer - all source portals with monthly job volumes
• FAQ - API billing, quotas, and common questions

Try It Out

Start with 1,000 free job postings per month (100 requests) on the Basic plan.