An Overview of the Adzuna Public API

Are you looking for a job search engine to integrate into your website or mobile application? Look no further than the Adzuna Public API! This handy tool allows you to access Adzuna's extensive database of job vacancies, salary data, and company information.

Getting Started

To get started with the Adzuna Public API, first register an account on the Adzuna Developer Website. This will give you access to the API key that you will need to make requests.

How to Get Adzuna API Credentials

Adzuna authenticates with two values — an App ID and an App Key — not a single token.

1. Register for free at the Adzuna developer portal.
2. After confirming your email, open your dashboard to find your Application ID (app_id) and Application Key (app_key).

Both are passed as query parameters on every request (there is no Authorization-header method):

const app_id = 'YOUR_APP_ID';
const app_key = 'YOUR_APP_KEY';
const url = `https://api.adzuna.com/v1/api/jobs/gb/search/1?app_id=${app_id}&app_key=${app_key}&what=javascript&where=london`;
fetch(url).then(res => res.json()).then(data => console.log(data));

The API is free within its rate limits; current per-day/per-month quotas and commercial terms are listed on the developer portal. The country is set in the path (/gb/, /us/, etc.).

Example Requests

Here are a few examples of how you can use the Adzuna Public API to fetch job data using JavaScript.

Search for Jobs

const app_id = 'YOUR_APP_ID';
const app_key = 'YOUR_APP_KEY';
const country = 'gb';
const query = 'javascript';
const location = 'london';
const url = `https://api.adzuna.com/v1/api/jobs/${country}/search/1?app_id=${app_id}&app_key=${app_key}&q=${query}&location=${location}`;

fetch(url)
    .then(response => response.json())
    .then(data => console.log(data));

Get Job Details

const app_id = 'YOUR_APP_ID';
const app_key = 'YOUR_APP_KEY';
const job_id = '123456789';
const url = `https://api.adzuna.com/v1/api/jobs/${job_id}?app_id=${app_id}&app_key=${app_key}`;

fetch(url)
    .then(response => response.json())
    .then(data => console.log(data));

Get Salary Data

const app_id = 'YOUR_APP_ID';
const app_key = 'YOUR_APP_KEY';
const country = 'gb';
const job_title = 'web developer';
const url = `https://api.adzuna.com/v1/api/salary/${country}/history?app_id=${app_id}&app_key=${app_key}&title_only=${job_title}`;

fetch(url)
    .then(response => response.json())
    .then(data => console.log(data));

These are just a few examples of the many ways in which you can use the Adzuna Public API to access job data. For more information, check out the API documentation.