get_salary_history
Analyze historical salary trends for specific job roles, locations, and categories to support salary negotiations and job market timing decisions.
Instructions
Get historical salary trends over time for matching jobs.
PURPOSE: Analyze how salaries have changed. Useful for: - "Are X salaries going up or down?" - Trend analysis for negotiations - Market timing for job searches
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 "month" array of data points: - month: Year-month string (YYYY-MM format) - salary: Average salary that month (annual, local currency)
Example response: { "month": [ {"month": "2024-01", "salary": 52000}, {"month": "2024-02", "salary": 52500}, {"month": "2024-03", "salary": 53000} ] }
How to analyze: - Compare first vs last month for overall change - Calculate % change: ((last - first) / first) * 100 - Look for consistent direction vs volatility
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 | ||
| months | No |