Documentation | Hiring Index

Authentication

Keys come from RapidAPI. Send yours in the x-rapidapi-key header; the free tier needs nothing else.

curl -X POST https://api.hiringindex.org/v2/jobs/search \
  -H "content-type: application/json" \
  -H "x-rapidapi-key: $ROLEBASE_KEY" \
  -d '{"job_titles":["Software Engineer"],"limit":20}'

Endpoints

POST /v2/jobs/search — filtered search, paginated.
POST /v2/jobs/insights — aggregates over the same filter shape.
GET /v2/jobs/{id} — a single posting.
POST /v2/jobs/export — bulk export task.

Methodology

Every posting in the index is read from a company applicant tracking system through its public catalogue API — ten vendors, no aggregators, no social networks. Where a source restricts automated access it is simply absent, and we would rather say that than claim coverage we do not have.

Age is counted from the publication date the employer set on the listing. Where a source publishes only a coarse date such as “30+ days ago”, we mark the field as approximate rather than guessing a day.

Salary figures use only postings that publish a range. Because disclosure varies by country and role, the disclosing share is printed next to every median on this site — a median over 12% of a cohort is a weaker number than one over 70%, and we would rather you saw that.

Counts are of postings, not of vacancies. One employer advertising three seats in one listing counts once.

Rate limits

The free tier allows 60 requests a minute, smoothed over a ten-minute window. If you need more, write to us before you start — we would rather raise the limit than watch you get throttled.