Skip to main content
POST
Market Insights
Compute aggregate market analytics over any cohort of jobs. The request accepts the same filter shape as Search Jobs — define a cohort with the filters you already know, and Hirebase returns salary distributions, remote mix, top technologies/skills, company breakdowns, and more.

Endpoint

Authentication

x-api-key
string
required
Your Hirebase API key. Required.

Request Body

Accepts the same filter shape as Search Jobs — e.g. job_titles, keywords, location_types, geo_locations, days_ago, industry, and so on. See the Search Jobs reference for the full filter list.

Response

The response is organized into the following top-level sections: headline, salary, salary_by_level, salary_by_location_type, level_breakdown, location_type_split, job_type_split, top_locations, top_companies, top_technologies, top_skills, top_benefits, education_split, company_size_split, industry_split, subindustry_split, visa_sponsorship_rate, recruiter_agency_rate, yoe_median, freshness, scores, scores_by_level, cached, and generated_at.
headline
object
Top-line KPIs for the cohort.
salary
object
Salary distribution for the cohort.
salary_by_level
object[]
Salary distribution broken out by experience level. Each item: { key, count, p25, p50, p75 }.
salary_by_location_type
object[]
Salary distribution broken out by work arrangement (Remote/Hybrid/In-Person). Each item: { key, count, p25, p50, p75 }.
top_technologies
object[]
Most common technologies. Each item: { key, count, percent }.
top_skills
object[]
Most common skills. Each item: { key, count, percent }.
top_benefits
object[]
Most common benefits. Each item: { key, count, percent }.
top_companies
object[]
Companies hiring most in the cohort. Each item: { company_name, company_slug, company_logo, count, percent }.
top_locations
object[]
Most common locations. Each item: { label, region, country, count, percent }.
level_breakdown
object[]
Distribution of jobs across experience levels.
location_type_split
object[]
Distribution across Remote / Hybrid / In-Person.
job_type_split
object[]
Distribution across job types (Full Time, Part Time, etc.).
education_split
object[]
Distribution across education requirements.
company_size_split
object[]
Distribution across company headcount buckets.
industry_split
object[]
Distribution across industries.
subindustry_split
object[]
Distribution across subindustries.
visa_sponsorship_rate
number
Percentage of jobs offering visa sponsorship.
recruiter_agency_rate
number
Percentage of jobs posted by recruiting agencies.
yoe_median
number
Median required years of experience.
freshness
object
Recency metrics for the cohort (e.g., how recently jobs were posted).
scores
object
Aggregate Hirebase quality scores for the cohort.
scores_by_level
object[]
Aggregate quality scores broken out by experience level.
cached
boolean
Whether the response was served from cache.
generated_at
string
Timestamp the insights were generated (ISO 8601).

Example Request

Example Response