search_jobs
Search Adzuna's job database with filters for location, keywords, salary, and employment type to find matching job openings.
Instructions
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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| what | No | ||
| where | No | ||
| company | No | ||
| country | Yes | ||
| sort_by | No | ||
| what_or | No | ||
| category | No | ||
| contract | No | ||
| distance | No | ||
| location | No | ||
| sort_dir | No | ||
| what_and | No | ||
| full_time | No | ||
| part_time | No | ||
| permanent | No | ||
| salary_max | No | ||
| salary_min | No | ||
| title_only | No | ||
| what_phrase | No | ||
| max_days_old | No | ||
| what_exclude | No | ||
| results_per_page | No | ||
| salary_include_unknown | No |