How to use Adzuna API?
Register for a developer account on Adzuna's developer site and you receive two credentials, an application id and an application key. Send both as the app_id and app_key query parameters on every request. Then call the job search endpoint for a country, passing a keyword in what and a place in where, and read the JSON results array.
The country and the page are part of the path rather than the query string: the search route is scoped by a two-letter country code, and the trailing path segment is the page number, so paging means requesting the next segment until results run out. Useful query parameters confirmed in the documentation include what_exclude to drop keywords, salary_min, full_time, permanent, sort_by and results_per_page. Each result carries a title, a description excerpt, company and location objects, a category, salary_min and salary_max, a created date and a redirect_url that sends the user to the advert through Adzuna. Check salary_is_predicted before displaying pay, because Adzuna estimates a salary when the advert states none. Beyond search there are endpoints for categories, salary histograms, top companies, regional vacancy counts and salary history. Read the terms of service too: they set default call limits and require a Jobs by Adzuna attribution.
Adzuna is strongest for aggregate labour-market questions and for the United Kingdom and Europe. When you need the full posting as the employer published it, JobsPipe fits alongside it. POST /v1/jobs/search takes job_title_or, company_name_or, skills_or, description_or and posted_at_gte, scopes to one board with source_or, and returns lifecycle fields such as status, so you can tell which postings are still open. Sources include LinkedIn, Indeed, Workday, Greenhouse, Lever and Ashby.
Start with one country and one keyword, log the total count, and page through a single query end to end before adding filters. If you want to compare record depth, run the same role through the JobsPipe sandbox search endpoint, which needs no key. The two are set side by side at jobspipe.dev/alternatives/adzuna.
The full treatment is on Job board and ATS APIs.
Related questions
How do I get an Adzuna API key?
Register on Adzuna's developer site. Signup is self-serve and gives you an application id and an application key as soon as you register. Both values are required on every call, passed as the app_id and app_key query parameters. No sales conversation is needed to start, although ongoing commercial use is covered by a separate licence under the terms of service.
What format does the Adzuna API return?
JSON by default, with a results array and a total count for search calls. The documentation also describes JSONP through a callback parameter for browser use, and XML as an alternative encoding. Most integrations use JSON and read the nested company, location and category objects, each of which has a display name rather than a bare string.
Does the Adzuna API have rate limits?
Yes. The terms of service set default limits on calls per minute, per day, per week and per month for each key, and higher volumes are arranged with Adzuna directly. The figures can change, so read the current terms before you design a polling schedule, and cache responses rather than repeating identical searches.
Can I use the Adzuna API in a commercial product?
The terms of service allow publishing job listings and salary estimates with Adzuna attribution, and personal research. They give commercial, government and academic organisations a trial period for evaluation, after which a licence agreement is required, and they restrict redistributing the data in raw or aggregated form without written consent. Read them before you build.
More answers
Query live postings yourself, 1,000 jobs a month free.
Get a free API key