adzuna_top_companies
Retrieve a leaderboard of employers with the most open vacancies for a given role, including vacancy count and average salary. Use this data to build a cold-outreach target list.
Instructions
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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |