Modified on: 16 Aug, 2026

Connecting to the Jooble REST API allows you to automatically retrieve job vacancies and integrate them into your platform. This step-by-step guide walks you through setting up your connection and passing your API key correctly.

Important Regional Restrictions:
Each Jooble domain (country) operates with its own unique REST API key. For instance, an API key obtained on jooble.org grants access exclusively to US market job data. To request job listings for other countries, you must register and generate a separate 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).

Step-by-Step Connection Process

1. Obtain your domain-specific API key:
   Visit the API registration page on the Jooble domain corresponding to your target country (e.g., jooble.org/api/about for the US). Complete the registration to generate your unique API key.
2. Review the API specifications:
   For a complete overview of request parameters, response structures, and JSON payload examples, please refer to our Jooble REST API Documentation.
3. Develop the connection code:
   Use code examples provided on the API portal to build your HTTP POST request in your preferred programming language (such as PHP, Python, JavaScript, C#, or Ruby).
4. Pass the API key in your requests:
   Ensure that every API request targets the correct regional endpoint and includes your valid domain-specific API key directly in the request URL path: POST https://jooble.org/api/{api_Key}.
5. Execute requests and handle JSON responses:
   Once connected, process the returned application/json response within your system to display job listings or extract specific data fields (such as title, location, salary, or direct vacancy links).

API terms and assistance

Please note that all API requests must comply with the Jooble API Terms of Use. If you encounter any technical issues or need assistance with your integration, please contact our support team.