Count job postings

Job Postings API

GET /api/v2/jobs/count - Job Postings API

Use this endpoint when you only need numbers - e.g. for labour market analysis or to size a query before paging through search. It accepts the same filters as search. This endpoint returns the total number of job postings matching the specified query parameters. The response is per default a simple JSON object containing the count of job postings as well as the used query send to the underlying database. With the format parameter other output formats can be requested.

Request

Base URL: https://daily-international-job-postings.p.rapidapi.com - authentication: see How to authenticate.

curl --request GET \
  --url 'https://daily-international-job-postings.p.rapidapi.com/api/v2/jobs/count?countryCode=de' \
  --header 'X-RapidAPI-Key: YOUR_API_KEY' \
  --header 'X-RapidAPI-Host: daily-international-job-postings.p.rapidapi.com'

Parameters

Parameter In Type Description
format query string The format of the output in json, csv, rss, atom, xml, or parquet (e.g., format=rss) Values: json, csv, rss, atom, xml, parquet.
dateCreated query string 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.
dateCreatedMin query string The starting date for a date range search of when the job posting was created or posted, using the format YYYY-MM-DD. Only used if dateCreated is empty; dateCreatedMin and dateCreatedMax must be used together.
dateCreatedMax query string The ending date for a date range search of when the job posting was created or posted, using the format YYYY-MM-DD. Only used if dateCreated is empty; dateCreatedMin and dateCreatedMax must be used together.
isDirect query string A flag indicating if the job posting URL or externalApplyUrl links directly to the company's website.
isDuplicate query string A flag indicating whether the job posting is considered a duplicate of another, either within the same source or across multiple sources. Note: We currently err on the safe side, resulting in more false duplicates than there are.
isActive query string A flag indicating if the job posting has a dateActive not yet reached.
isRecruiter query string A flag indicating if the job posting was posted by a recruiting firm.
title query string Free-text search within the title of the job postings.
skills query string The skills, keywords, or tags associated with the job posting.
language query string 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'.
contractType query string The type of employment contract extracted from the job posting such as permanent, temporary, internship, etc.
workType query string The type of work duration extracted from the job posting such as fulltime, parttime, flextime, etc.
workPlace query string The workplace of the job, extracted from the job posting such as remote, hybrid, onsite, field, offshore, etc.
hasSalary query string A flag indicating if the job posting contains salary information.
minSalary query number The minimum salary of the job posting. Can be yearly, monthly, or hourly and any currency (exact data is stated in JsonLD result).
industry query string The industry extracted from the job posting or categorization in the job board, such as advertising, agriculture, it, healthcare, etc.
company query string The company that posted the job posting (can be a recruiting firm).
department query string The department extracted from the job title such as, finance, it, hr, sales, etc.
occupation query string The occupation type extracted from the job title reduced to a stem form incl. several synonyms. For example: programmer, executive, manager, engineer, nurse, etc.
countryCode query string 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.
state query string The state the workplace is located in, extracted from the job posting or geo-location.
city query string The city the workplace is located in, extracted from the job posting or geo-location.
postCode query string The postal / zip code the workplace is located in, extracted from the job posting or geo-location.
timezone query string The timezone the job is located in such as CET, PST, or UTC
timezoneOffset query integer The numeric offset of the timezone from UTC.
timezoneMin query integer The minimum numeric offset of the timezone from UTC. Requires a 'timezoneMax' value greater than 'timezoneMin' to search in a timezone range.
timezoneMax query integer The maximum numeric offset of the timezone from UTC. Must be larger than 'timezoneMin' to search in a timezone range.
geoPointLat query number The geographic latitude of a GeoPoint used in a distance search.
geoPointLng query number The geographic longitude of a GeoPoint used in a distance search.
geoDistance query string The distance from a GeoPoint specified with 'geoPointLat' and 'geoPointLng'.
geoTopLeftLat query number The geographic latitude of the top left GeoPoint in a bounding box search.
geoTopLeftLng query number The geographic longitude of the top left GeoPoint in a bounding box search.
geoBottomRightLat query number The geographic latitude of the bottom right GeoPoint in a bounding box search.
geoBottomRightLng query number The geographic longitude of the bottom right GeoPoint in a bounding box search.
portal query string The portal the job postings originated from.
source query string The specific source with countrycode the job postings originated from such as careerjet, monster, linkedin, techmap, etc.

Responses

Status Description
200 Success - indicating a correct query execution with results
400 Bad Request - A parameter value could not be parsed, e.g. an unknown countryCode, an invalid date or sort value. Solution: Check the value against the parameter description. The message names the invalid parameter.
401 Unauthorized - The key is missing or invalid, or the request was sent directly to the backend instead of RapidAPI. Solution: Send your key in the header X-RapidAPI-Key and use the base URL https://daily-international-job-postings.p.rapidapi.com. Copy the key again from the RapidAPI listing if it was rotated.
403 Forbidden - Either you are not subscribed to this API ("You are not subscribed to this API."), or the endpoint is not included in your plan (e.g. /api/v2/meta/jobs/distinct and /api/v2/meta/jobs/statistics need at least the Pro plan). Solution: Subscribe to the Basic plan, or upgrade to the plan named in requiredPlan. The response contains message, requiredPlan and pricingUrl.
404 Not Found - The endpoint path does not exist (typo, wrong API version) or a required search parameter is missing, or the requested field does not exist. Solution: Check the path and add at least one search parameter (e.g. countryCode). The message lists the allowed parameters or fields.
405 Method Not Allowed - Another HTTP method than GET was used. Solution: Use GET.
429 Too Many Requests - Too many requests in a short time window (rate limit of your RapidAPI plan, e.g. 1 request/second on Basic). This is not a monthly limit - the plans have no hard limit, extra requests are billed as overage. RapidAPI also answers 429 after repeated calls with an invalid key. Solution: Slow down and retry with exponential backoff (e.g. 1 s, 2 s, 4 s). If it persists, check that your key is valid.
500 Internal Server Error - An unexpected error on our side. Solution: Retry once. If it persists, contact data@techmap.io with the full request URL (without your key).
503 Service Unavailable - The search backend is temporarily unavailable. Solution: Retry later with exponential backoff.

Example response

{
  "api": "Techmap.io Job Posting API",
  "apiVersion": "v2.7.1",
  "apiEndpoint": "GET count for Job Postings by countryCode, dateCreated, language, industry, timezone, workPlace, etc.",
  "totalCount": "6937315",
  "query": {
    "query": {
      "bool": {
        "must": [],
        "must_not": [],
        "should": []
      }
    }
  },
  "resultSizeInBytes": "363"
}

Interactive reference with all schemas: Job Postings API reference.