Job Countries API Endpoint Documentation

A list of countries available for job search.

Table of contents


The Job Countries endpoint provides a comprehensive list of countries where job postings are available within the jobdata API. This endpoint enables users to filter job listings based on the country of origin, facilitating targeted job searches tailored to specific geographic locations.

Endpoint Overview

Endpoint (list): /api/jobcountries/

Endpoint (single element): /api/jobcountries/{id}/

Method: GET

Authorization Required: Yes

Description: Retrieves a list of all countries with available job postings within the jobdata API database. This endpoint is essential for users who wish to filter job listings by country, either for localized job searches or for analyzing job market trends in specific regions.


To make a request to the Job Countries endpoint, users must include an authorization header with their API key. Below are examples demonstrating how to make a request using curl and Python.

Using curl

curl -X GET "" \
     -H "Authorization: Api-Key YOUR_API_KEY"

Using Python

import requests

url = ""
headers = {"Authorization": "Api-Key YOUR_API_KEY"}
response = requests.get(url, headers=headers)


This endpoint does not require any query parameters. The authorization header with the API key is the only requirement to access the data.


The response from the Job Countries endpoint is a JSON object containing an array of countries with available job postings. Each country object includes information such as the country code, name, and region.

Example Response

    "code": "US",
    "name": "United States",
    "region": {
      "id": 5,
      "name": "North America"
    "code": "GB",
    "name": "United Kingdom",
    "region": {
      "id": 3,
      "name": "Europe"
  // Additional country objects...

Use Cases

  • Localized Job Searches: Job seekers can utilize the Job Countries endpoint to filter job listings based on their desired geographic location, allowing for more targeted job searches within specific countries.
  • Market Analysis: Researchers and analysts can leverage the country data provided by this endpoint to conduct market analysis on job trends in different regions, gaining insights into employment patterns and opportunities worldwide.
  • International Recruitment: Businesses and recruiters can use this endpoint to identify countries with high job demand or talent pools in specific industries, aiding in international recruitment efforts.


  • Ensure to replace YOUR_API_KEY with your actual jobdata API key in the authorization header.

This documentation section offers a detailed overview of how to interact with the Job Countries endpoint, enabling users to effectively filter and analyze job postings based on geographic location.

Related Docs

Jobs API Endpoint Documentation
Job Cities API Endpoint Documentation
Job Types API Endpoint Documentation
Full-Text Search on Job Descriptions
Job Regions API Endpoint Documentation
Jobs Expired API Endpoint Documentation
CSV File Downloads Documentation