Hiring and job openings
get_postingsRead-onlyIdempotent
Use for: hiring, job openings, labor demand and labor market conditions; is hiring rising or falling; where demand for an occupation is growing; which industries or companies are hiring; company strategy shown by shifts in hiring. Job ads first posted, by period, for an occupation, company, industry and place, with optional change over time. Counts are ads, not hires.
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_...). | |
| interval | No | Period type. Default month; prefer quarter or year for pay. | |
| 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. | |
| 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. |