Hiring and pay statistics
market_statsAggregate statistics for a slice of the job market in one call - the answer to "how much does X earn in Y", "how many companies hire X", "is demand for X growing", "which employers hire X most", "how fast do such roles close". Takes the same filters as search_jobs (role, country, city, seniority, work_mode, employment_type, technology, query, company, industry, visa_sponsorship, has_equity, salary_min_usd) plus window_days, and returns: open postings and hiring companies now; new postings in the last 30 days against the 30 before (trend_30d_pct); work-mode and seniority mix; salary percentiles p10-p90 in USD per year, stated (midpoint of the posted range) and estimated separately, with the salary transparency rate; time to fill in days (first seen to confirmed closed on the employer board); the top 10 employers, and - among the 3000 newest open postings of the slice - the top 15 required technologies and the top countries (when no country is given) with their shares. Every block carries its sample size n; percentiles are null under 5 postings rather than guessed. Drill into any figure with search_jobs and the same filters. Answers are cached for up to 6 hours; a block that could not be computed in time is named under partial and its figures are null (unknown, not zero) - repeat the call in about a minute for the whole answer. Costs 2 units per call. Docs: https://alion.io/developers/docs
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name prefix. | |
| role | No | Role or role family by name, e.g. "Backend", "Data Engineer", "Product Manager". | |
| query | No | Free-text words that must appear in the title or description. | |
| company | No | One employer by id, domain or exact name. | |
| country | No | ISO 3166-1 alpha-2 code or country name. | |
| industry | No | Industry of the posting or its employer, e.g. "Fintech", "Real Estate". | |
| seniority | No | Seniority of the role: intern, junior, middle, senior, staff, lead or head. | |
| work_mode | No | Where the work happens: on_site, hybrid or remote. | |
| has_equity | No | Only postings that offer equity. | |
| technology | No | A required technology, e.g. "Rust", "Kubernetes". | |
| window_days | No | How far back the salary and time-to-fill samples reach (postings first seen in the window). | |
| salary_min_usd | No | Minimum annual pay in USD: a stated range whose top reaches it, or an estimate whose midpoint does. | |
| employment_type | No | Kind of engagement: full_time, part_time, contractor, cofounder, freelance or internship. | |
| include_agencies | No | Include postings by staffing agencies and intermediaries (left out by default). | |
| visa_sponsorship | No | Only postings that state visa sponsorship. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | Quota and credit standing after this call. | |
| as_of | No | ||
| cached | No | ||
| demand | No | ||
| salary | No | ||
| sample | No | ||
| partial | No | Blocks that did not finish in time: their figures are null (unknown, not zero) | |
| warnings | No | ||
| top_countries | No | ||
| top_employers | No | ||
| filters_applied | Yes | ||
| seniority_share | No | ||
| work_mode_share | No | ||
| top_technologies | No | ||
| time_to_fill_days | No | Days from first seen to confirmed closed |