Modified on: 16 Aug, 2026

This guide provides documentation for integrating with the Jooble REST API. Below you will find information about API key generation, endpoints, request parameters, JSON formats, and common response codes. If you haven't initiated the integration yet, please refer to our step-by-step guide on How to Connect to the Jooble REST API.

Important Regional Restrictions:
Each Jooble domain (country) requires its own unique REST API key. For instance, a key generated on jooble.org provides access exclusively to US job listings. To query vacancies for other countries, register and obtain an API key on the corresponding regional domain (e.g., uk.jooble.org/api/about for the UK or de.jooble.org/api/about for Germany).
API Usage Limits:
The free REST API plan includes a total lifetime limit of 500 requests per key (this is an absolute lifetime quota, not a monthly limit).

How to Obtain a Jooble REST API Key

  1. Register an account on the Jooble API portal for your target country (e.g., jooble.org/api/about).
  2. Once registered, copy and securely store your generated API key.

Request Parameters (JSON Body)

The request payload must be sent in application/json format with the following parameters:

  • keywords(string, required): Keywords or job titles to search for.
  • location(string, required): Location name (city, region, or country).
  • radius(string, optional): Search radius in kilometers. Allowed values: 0, 4, 8, 16, 26, 40, 80.
  • salary(integer, optional): Minimum salary threshold.
  • page(integer, optional): Page number of the search results (default is 1).
  • ResultOnPage(integer, optional): Number of job items returned per page.
  • SearchMode(integer, optional): Search algorithm mode (default is 0).
  • companysearch(boolean, optional):
    • true – Search keywords specifically within company names.
    • false – Search keywords in job titles and descriptions.

Response Parameters

Upon a successful request, the server returns a JSON object containing:

  • totalCount(integer): Total number of matching jobs found.
  • jobs(array): List of job objects containing:
    • id(integer): Unique job posting identifier.
    • title(string): Job title.
    • location(string): Job location.
    • snippet(string): Brief description snippet displayed in search results.
    • salary(string): Salary range formatted as {min} - {max} {currency}.
    • source(string): Source of the vacancy posting.
    • type(string): Employment type (e.g., Full-time, Part-time).
    • link(string): Direct URL to the job posting on Jooble.
    • company(string): Company name.
    • updated(string): ISO timestamp of the last vacancy update.

JSON Request & Response Examples

Example Request Payload:

POST https://jooble.org/api/{api_Key} Content-Type: application/json { "keywords": "Sales Manager, Administrator", "location": "Kyiv", "radius": "80", "page": "1", "companysearch": "false" }

Example Success Response (200 OK):

{ "totalCount": 1, "jobs": [ { "id": 1234567890, "title": "Sales Manager", "location": "Kyiv", "snippet": "This is a great opportunity to join our team...", "salary": "17,600 UAH", "source": "jooble", "type": "Full-time", "link": "https://ua.jooble.org/jdp/12345", "company": "ABC Corp", "updated": "2023-09-15T12:55:35.3870000" } ] }

HTTP Response & Error Codes

  • 200 OK: Request was successful and returned data.
  • 403 Access Denied: Invalid or missing API key.
  • 404 Not Found: The requested endpoint or resource does not exist.

Code Implementation Examples

You can integrate the Jooble REST API using programming languages such as PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby, and others. Ready-to-use code snippets and implementation guides are available on our Jooble API Documentation Page.