📚 Documentation & Examples
Everything you need to integrate with Jooble
🚀 Quick Start Examples
// Jooble API Example
const response = await fetch('https://jooble.org/api/about', {
method: 'GET',
headers: {
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);A Quick Guide to Using the Jooble API in JavaScript
Jooble is a popular job search engine that features job listings from a wide range of sources. The Jooble API allows developers to access and integrate Jooble's massive job database into their own applications. In this guide, we'll walk you through how to get started with the Jooble API in JavaScript.
How to Get a Jooble API Key
Jooble hands out API keys through a short request form — it's free.
- Visit the Jooble API page.
- Fill in the request form (name, position, email, company website, and phone).
- Click Send request. Jooble emails you a personal API key.
Note the auth model: your key is part of the request URL path, and searches are sent as an HTTP POST with a JSON body — not a GET with query parameters.
const key = 'YOUR_API_KEY';
const res = await fetch(`https://jooble.org/api/${key}`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ keywords: 'java developer', location: 'New York' })
});
const data = await res.json();
Common body fields include keywords, location, salary, and page. See the request form page for current usage limits.
Making a Request
The Jooble API takes an HTTP POST request with your key in the URL path and the search filters in a JSON body:
const apiKey = 'your_api_key_here';
fetch(`https://jooble.org/api/${apiKey}`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ keywords: 'javascript developer', location: 'Remote' })
})
.then(response => response.json())
.then(data => console.log(data.jobs));
GET requests are not supported — sending one returns an error.
Query Parameters
The Jooble API allows you to specify a wide range of query parameters to filter your job search results. Some of the most commonly used parameters include:
keywords: The keywords to search for in the job listings.location: The location to search for jobs in.salary: The minimum salary for the job.age: The maximum age of job listings to return.page: The page number of job listings to return.
These filters go in the JSON body of your POST request:
const apiKey = 'your_api_key_here';
fetch(`https://jooble.org/api/${apiKey}`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ keywords: 'java developer', location: 'New York', page: 1 })
})
.then(response => response.json())
.then(data => console.log(data.jobs));
Here we filter by keywords and location; add any of the other parameters to the same JSON body.
Authentication
There are no headers or tokens: authentication is just your API key embedded in the request path (https://jooble.org/api/{YOUR_API_KEY}), with every call sent as a POST. Keep the key out of client-side code since anyone who sees the URL can use your quota.
Conclusion
The Jooble API is a powerful tool for developers to access and integrate job search data into their own applications. With just a few lines of JavaScript, you can easily make requests to the API and filter job listings based on a wide range of parameters. Happy coding!
