get_geodata
Compare salaries and job availability across geographic regions to identify high-paying opportunities and relocation options.
Instructions
Get salary and job count data broken down by geographic region.
PURPOSE: Compare salaries and job availability across areas. Useful for: - "Where are the highest paying X jobs?" - "Which cities have the most opportunities?" - Relocation decisions
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 "locations" array of region objects: - location.display_name: Region name - location.area: Geographic hierarchy array - count: Number of jobs in region - average_salary: Average salary (may be null)
Example response: { "locations": [ { "location": {"display_name": "London", "area": ["UK", "London"]}, "count": 15678, "average_salary": 62000 }, { "location": {"display_name": "Manchester", "area": ["UK", "Manchester"]}, "count": 3456, "average_salary": 48000 } ] }
Notes: - Results ordered by job count (most jobs first) - average_salary is ANNUAL in LOCAL CURRENCY - Typically returns 10-20 top regions
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 |