get_top_companies
Find top employers by hiring volume to identify major companies actively recruiting in specific fields, locations, or countries.
Instructions
Get top employers currently hiring, ranked by number of open positions.
PURPOSE: Identify major employers in a field. Useful for: - "Which companies are hiring the most engineers?" - Researching potential employers - Understanding market leaders by hiring volume
NOTE: Shows hiring VOLUME, not company quality. Smaller great companies may not appear.
Args: country: ISO 3166-1 alpha-2 country code. Supported: "gb", "us", "de", "fr", "au", "nz", "ca", "in", "pl", "br", "at", "za"
Returns: dict: Contains "leaderboard" array of company objects: - canonical_name: Company name (normalized) - count: Number of open positions - average_salary: Average salary across listings (may be null)
Example response: { "leaderboard": [ {"canonical_name": "NHS", "count": 1245, "average_salary": 42000}, {"canonical_name": "Amazon", "count": 567, "average_salary": 65000}, {"canonical_name": "Google", "count": 234, "average_salary": 95000} ] }
Notes: - Ranked by job count (most positions first) - Typically returns 10-20 companies - average_salary is ANNUAL in LOCAL CURRENCY (may be null)
Errors: - Invalid country code: "API Error 400: Invalid country" - Invalid category: "API Error 400: Invalid category tag" - Rate limit exceeded: "API Error 429: Too many requests" - Authentication failure: "API Error 401: Invalid credentials"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | Yes | ||
| keywords | No | ||
| location | No | ||
| category | No |