Jooble Help Center

Here you can find information about endpoints, response parameters, and possible code errors after connecting with your REST API key. If you haven't connected yet, follow the steps in this guide to get started.

How to Get the API Key?
Register on the website: https://jooble.org/api/about 
After registration, copy and save the API key that is generated for you.

Endpoints
Below you can find the available endpoints that you can use to interact with the Jooble REST API to retrieve the desired data.

Request Parameters:
POST /api/{api_Key} 

• keywords: Keywords to search for jobs by.
• location: Location to search for jobs in.
• radius (optional): Search radius, converted to kilometers (type: string).
• salary (optional): Minimum salary for the job search (type: integer).
• page (optional): The page number of the search results.
• ResultOnPage (optional): Number of jobs displayed on each page.
• SearchMode (optional): The search mode, default is 0.
• companysearch (optional):
  • true – To search for keywords in the company name of the job.
  • false – To search for keywords in the job title or description.

Response Parameters:

• totalCount: Total number of jobs found for the search request.
• jobs: A list of jobs that match the search criteria:
• title: Job title.
• location: Job location.
• snippet: Job description snippet displayed in search results.
• salary: Salary range in the format {job.salary_val1} - {job.salary_val2} {currency}.
• source: The source of the job posting.
• type: Job type (full-time, part-time, etc.).
• link: URL to the job posting.
• company: Company name.
• updated: Date and time when the job was last updated.
• id: Unique job identifier.

Json Example Request
POST https://jooble.org/api/{api_Key}

{
  "keywords": "Sales Manager, Administrator",
  "location": "Kyiv",
  "radius": "80",
  "page": "1",
  "companysearch": "false"
}

Success Response: 200 OK

{  "totalCount": 1,  
    "jobs": [    
    {   "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",      
        "id": 1234567890    }  ] 
}

Error Responses:
403: Access denied – Invalid API key.
404: Not found – The requested endpoint or resource is not available.

Example of Using the Jooble API in Code
You can implement the Jooble API using PHP, JavaScript, Ruby, C# (.NET 4 or later), Python 3.5, or Python 2.7. Detailed code examples for each language can be found on the Jooble API about page, just show it to your programmer.

Jooble REST API Documentation Guide Endpoints