Search Adzuna's job listings.

country: ISO country code Adzuna covers, e.g. "gb", "us", "de", "fr", "it". what: keywords where ALL words must match (AND). For multi-word roles like "Senior Lead Data Engineer" this can silently return zero results; use what_or instead to match ANY of the words. what_or: keywords where ANY word may match (OR) - higher recall than what. what_and: same as what (all words must match), explicit alternate name. what_phrase: an exact phrase that must appear in the title or description. what_exclude: keywords to exclude from results. title_only: keywords to match, restricted to the job title only. where: geographic centre of the search - a city, region, or postal code (NOT a country name; combine with country for that). A bad value here silently returns no results rather than erroring. distance: search radius in km around where. Defaults to 5km if omitted. location: a hierarchical place, most general first, e.g. ["UK", "South East England", "Buckinghamshire"]. See regional_data for how to discover valid values. category: a category tag as returned by list_categories. sort_by / sort_dir: how to order results (e.g. sort_by="salary"). salary_min / salary_max: salary bounds to filter on. salary_include_unknown: also include jobs with no listed salary. full_time / part_time / contract / permanent: filter by employment type. results_per_page: number of results per page (page size), default is set server-side by Adzuna if omitted.

List Adzuna's job category tags for a country (e.g. "it-jobs", "sales-jobs").

country: ISO country code, e.g. "gb", "us", "de". Category tags returned here can be passed as the category param to search_jobs, salary_histogram, top_companies, regional_data, and historical_salary.

Get the current distribution of salaries for a job search as a histogram.

Each key in the returned histogram is the lower bound of a salary band; the value is the number of vacancies whose salary falls in that band.

country: ISO country code, e.g. "gb", "us", "de". what: keywords to filter jobs by (AND semantics, all words must match). category: a category tag as returned by list_categories. location: a hierarchical place, most general first, e.g. ["UK", "London"]. See regional_data for how to discover valid values.

Get a leaderboard of the top 5 employers by number of vacancies.

country: ISO country code, e.g. "gb", "us", "de". what: keywords to filter jobs by (AND semantics, all words must match). category: a category tag as returned by list_categories. location: a hierarchical place, most general first, e.g. ["UK", "London"]. See regional_data for how to discover valid values.

Get vacancy counts for each sub-region of a given location.

Also useful for discovering the exact area strings Adzuna expects for the location param on other tools - each returned location includes an area array you can reuse verbatim.

country: ISO country code, e.g. "gb", "us", "de". category: a category tag as returned by list_categories. location: a hierarchical place, most general first, e.g. ["UK", "West Midlands"]. Omit to get the country's top-level regions.

Get average salary by month for a category and/or location, over time.

Returned keys are "YYYY-MM" strings; order is not guaranteed by the API.

country: ISO country code, e.g. "gb", "us", "de". category: a category tag as returned by list_categories. months: how many months of history to return. location: a hierarchical place, most general first, e.g. ["UK", "London"]. See regional_data for how to discover valid values.

Get the current Adzuna API version - useful for debugging connectivity/auth.