get_salary_histogram
Analyze salary distribution for jobs matching specific criteria to understand market rates, support negotiation research, and identify typical pay ranges for roles in various locations and categories.
Instructions
Get salary distribution histogram for jobs matching search criteria.
PURPOSE: Understand salary ranges in a job market. Useful for: - "What's the typical salary for X role?" - Salary negotiation research - Market positioning analysis
IMPORTANT: Only includes jobs WITH listed salaries. Many jobs don't list salary.
Args: country: ISO 3166-1 alpha-2 country code. Determines currency. Supported: "gb", "us", "de", "fr", "au", "nz", "ca", "in", "pl", "br", "at", "za"
Returns: dict: Contains "histogram" object with salary buckets: - Keys: Salary values as strings (e.g., "30000", "35000") - Values: Number of jobs at that salary point
Example response: { "histogram": { "25000": 89, "30000": 234, "35000": 456, "40000": 567, "45000": 489, "50000": 378, "55000": 245, "60000": 167 } }
How to interpret: - Keys are ANNUAL salaries in LOCAL CURRENCY - Buckets are typically £5,000 / $5,000 increments - Peak of distribution = most common salary - To find median: find salary where cumulative count reaches 50%
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 |