Pay and salaries for a job and place
get_payRead-onlyIdempotent
Use for: what does a job pay, salary, wages, hourly rate or earnings for an occupation in a city, metro, state or country, or at a company; pay trends and how pay compares with the market. Advertised pay percentiles (p10-p90) from job ads, by period, for an occupation, company, industry and place, with optional change over time and market benchmarks. Pay is advertised pay, not actual pay.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| split | No | 'brand' with parent_company_id or ticker: one row set per brand. | |
| soc_id | No | SOC 2018 occupation IDs, e.g. soc_29-1141 (geography and job level only). | |
| ticker | No | Stock ticker, e.g. MAR: the listed company's whole group. | |
| compare | No | Add change vs the previous period or 12 months earlier. | |
| country | No | ISO 3166-1 alpha-2 country, e.g. US, GB. Required unless location_id is given. | |
| role_id | No | GWIX role IDs (rol_...). | |
| currency | No | USD (default) or each country's own currency. | |
| interval | No | Period type. Default month; prefer quarter or year for pay. | |
| pay_unit | No | ||
| benchmark | No | national, local, industry, local_industry (needs an occupation filter). | |
| company_id | No | Brand-level company IDs (cmp_...), from find_id type company. | |
| end_period | No | Last period label. Default: the latest complete period. | |
| industry_id | No | 4-digit NAICS industry groups, comma-separated. | |
| location_id | No | Country (US), state (US-CO) or metro (mtr_...) IDs, from find_id type location. Use this or country. | |
| percentiles | No | Subset of p10,p25,p50,p75,p90. | |
| job_level_id | No | lvl_entry, lvl_intermediate or lvl_senior; absent = all levels. | |
| start_period | No | First period label, e.g. 2026-Q2, 2026-03, 2025. Default: the latest complete period. | |
| job_family_id | No | Job family IDs (jfm_...), from find_id type job_family. | |
| occupation_code | No | Occupation codes as <system>:<code>, comma-separated: soc_2018:15-1252, isco_08:2512, esco:2512.4, onet_soc:15-1252.00, soc_2010:15-1132. Returns one row set per SOC 2018 occupation the code maps to. | |
| parent_company_id | No | Ultimate parent company ID (cmp_...): the whole group. | |
| sub_job_family_id | No | Sub-job family IDs (sjf_...), from find_id type sub_job_family. | |
| benchmark_industry_id | No | 4-digit NAICS for industry benchmarks. |