Search Adzuna's job advertisement database with keyword, location, salary and contract filters.

Returns ads including title, employer, location, salary range (annual, local currency), contract type, category, posting date and a redirect_url. Adzuna only returns a SNIPPET of each description — fetch the redirect_url to read the full ad.

Args: params (SearchJobsInput): Validated search parameters. Key fields: - country (str): ISO code, default 'gb' - what / what_or / what_and / what_phrase / what_exclude / title_only (Optional[str]): keyword filters - where (Optional[str]) + distance (Optional[int]): free-text location and radius in km - location0/1/2 (Optional[str]): hierarchical location filter - category (Optional[str]): tag from adzuna_list_categories - salary_min / salary_max (Optional[int]): annual salary bounds - full_time / part_time / permanent / contract (Optional[bool]): contract filters - max_days_old (Optional[int]), sort_by (Optional[SortBy]), page, results_per_page - response_format (ResponseFormat): 'markdown' or 'json'

Returns: str: Markdown summary of matching ads, or JSON with keys count (int, total matches), mean (float, mean salary) and results (list of job objects each containing id, title, description, created, redirect_url, salary_min, salary_max, salary_is_predicted, contract_type, contract_time, latitude, longitude, company{display_name}, location{display_name, area[]}, category{label, tag}). On failure, an 'Error: ...' string explaining the cause.

List the job categories Adzuna applies in a given country.

Call this before using the category filter on other tools — tags are country-specific and must match exactly (e.g. 'it-jobs', 'scientific-qa-jobs').

Args: params (CategoriesInput): Validated parameters containing: - country (str): ISO code, default 'gb' - response_format (ResponseFormat): 'markdown' or 'json'

Returns: str: Markdown table of tag/label pairs, or JSON with key results (list of objects with tag (str) and label (str)). On failure, an 'Error: ...' string explaining the cause.

Get the current distribution of advertised salaries for a role and/or location.

Each key is the LOWER bound of an annual salary band in local currency; each value is the number of live vacancies in that band. Use it to sanity-check a salary expectation or to see where a target figure sits in the market.

Args: params (HistogramInput): Validated parameters containing: - country (str): ISO code, default 'gb' - what (Optional[str]): role keywords - location0/1/2 (Optional[str]): hierarchical location filter - category (Optional[str]): category tag - response_format (ResponseFormat): 'markdown' or 'json'

Returns: str: Markdown table of salary band vs vacancy count, or JSON with key histogram (dict mapping salary-band lower bound (str) to vacancy count). Band order is not guaranteed by the API; this tool sorts it. On failure, an 'Error: ...' string explaining the cause.

Get the average advertised salary month by month for a role, category and/or location.

Shows whether pay for a role is trending up or down over time.

Args: params (HistoryInput): Validated parameters containing: - country (str): ISO code, default 'gb' - what (Optional[str]): role keywords - location0/1/2 (Optional[str]): hierarchical location filter - category (Optional[str]): category tag - months (Optional[int]): months of history to return - response_format (ResponseFormat): 'markdown' or 'json'

Returns: str: Markdown table of month vs average salary, or JSON with key month (dict mapping 'YYYY-MM' (str) to average annual salary (float)). Month order is not guaranteed by the API; this tool sorts it. On failure, an 'Error: ...' string explaining the cause.

Get the number of live vacancies in the sub-regions of a location.

Doubles as the discovery tool for location filters: the area array on each result holds the exact strings to pass as location0/location1/location2 elsewhere. Call with no location to see a country's top-level regions.

Args: params (GeodataInput): Validated parameters containing: - country (str): ISO code, default 'gb' - location0/1/2 (Optional[str]): area whose children to list - category (Optional[str]): category tag to limit counts - response_format (ResponseFormat): 'markdown' or 'json'

Returns: str: Markdown table of sub-region, vacancy count and area path, or JSON with key locations (list of objects with count (int) and location {display_name (str), area (list[str])}). On failure, an 'Error: ...' string explaining the cause.

Get a leaderboard of the employers with the most open vacancies for a search.

Useful for building a cold-outreach target list: it surfaces who is hiring at volume for a role and roughly what they pay, which a plain job search does not.

Args: params (TopCompaniesInput): Validated parameters containing: - country (str): ISO code, default 'gb' - what (Optional[str]): role keywords - location0/1/2 (Optional[str]): hierarchical location filter - category (Optional[str]): category tag - response_format (ResponseFormat): 'markdown' or 'json'

Returns: str: Markdown table of employer, vacancy count and average salary, or JSON with key leaderboard (list of objects with canonical_name (str), count (int) and average_salary (float)). Feed canonical_name back into adzuna_search_jobs company to list that employer's ads. On failure, an 'Error: ...' string explaining the cause.

Estimate an annual salary for a role from its title and description (Adzuna Jobsworth).

Unlike the histogram/history tools (which summarise live ads), this predicts a single figure for a specific role you describe — useful for pricing a CV target or sanity-checking a job ad that states no salary. Feed it a job title plus the ad body or a skills summary.

Args: params (JobsworthInput): Validated parameters containing: - country (str): ISO code, default 'gb' - title (str): the job title to price - description (str): role/skills text; the full JD works well - response_format (ResponseFormat): 'markdown' or 'json'

Returns: str: Markdown with the estimated annual salary, or JSON with key salary (float, local currency). The salary key is absent when Adzuna cannot produce an estimate. On failure, an 'Error: ...' string explaining the cause.