Job API Overview

Table of Contents

1. API Overview

Techmap collects job postings from 127+ 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. Include it as Authorization: Bearer <your-api-key> in every request header.

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 30 requests (300 job postings) per month.
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/api/v2/jobs):

• GET /search - Returns up to 10 job postings per page matching the query. Available on all plans.
• GET /count - Returns the total count matching the query without returning job data. Useful for analytics and pagination planning. Available on all plans.
• GET /distinct - Returns distinct values and counts for a selected field (e.g., industry, workPlace, careerLevel) over the last 30 days. Available on ULTRA and MEGA plans.
• GET /statistics - Returns statistical summaries (counts, averages, distributions) per field for the last 30 days. Available on ULTRA and MEGA plans.

Job Postings RSS API Endpoints

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

• GET /jobs_full - Returns job postings in RSS 2.0 (XML) format, including full description and metadata.

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 "Authorization: Bearer <your-token>"
• 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 "Authorization: Bearer <your-token>"
• 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 "Authorization: Bearer <your-token>"

2.3 Pagination

The /search endpoint returns 10 job postings per page. Use totalCount from the response to determine how many pages exist.

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 = {"Authorization": "Bearer <your-api-key>"}

params = {
    "countryCode": "de",
    "dateCreated": "2026-05",
    "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 = {"Authorization": "Bearer <your-api-key>"}

params = {
    "countryCode": "us",
    "dateCreated": "2026-05",
    "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 = {"Authorization": "Bearer <your-api-key>"}

months = ["2026-03", "2026-04", "2026-05"]
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")

2.5 Error Handling

Example 400 response body:

{ "error": { "type": "search_phase_execution_exception", "reason": "cannot parse empty date" } }

Example 403 response body:

{ "message": "Forbidden request to the API. BASIC subscription plan is NOT sufficient." }

3. Data Dictionary

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

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
• 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 1000 free job postings per month on the Basic plan. No credit card required.