Market Insights

curl --request POST \
  --url https://api.hirebase.org/v2/jobs/insights \
  --header 'x-api-key: <x-api-key>'

const options = {method: 'POST', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://api.hirebase.org/v2/jobs/insights', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hirebase.org/v2/jobs/insights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hirebase.org/v2/jobs/insights"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/insights")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "headline": {
    "total_count": 123,
    "sample_size": 123,
    "median_salary": 123,
    "salary_currency": "<string>",
    "pct_disclosing_salary": 123,
    "pct_remote": 123,
    "top_company": "<string>",
    "top_technology": "<string>",
    "dominant_experience_level": "<string>",
    "new_this_week": 123
  },
  "salary": {
    "count": 123,
    "avg": 123,
    "p25": 123,
    "p50": 123,
    "p75": 123,
    "p90": 123,
    "min": 123,
    "max": 123,
    "currency": "<string>",
    "histogram": [
      {}
    ],
    "fitted_normal": {}
  },
  "salary_by_level": [
    {}
  ],
  "salary_by_location_type": [
    {}
  ],
  "top_technologies": [
    {}
  ],
  "top_skills": [
    {}
  ],
  "top_benefits": [
    {}
  ],
  "top_companies": [
    {}
  ],
  "top_locations": [
    {}
  ],
  "level_breakdown": [
    {}
  ],
  "location_type_split": [
    {}
  ],
  "job_type_split": [
    {}
  ],
  "education_split": [
    {}
  ],
  "company_size_split": [
    {}
  ],
  "industry_split": [
    {}
  ],
  "subindustry_split": [
    {}
  ],
  "visa_sponsorship_rate": 123,
  "recruiter_agency_rate": 123,
  "yoe_median": 123,
  "freshness": {},
  "scores": {},
  "scores_by_level": [
    {}
  ],
  "cached": true,
  "generated_at": "<string>"
}

POST

jobs

insights

Market Insights

curl --request POST \
  --url https://api.hirebase.org/v2/jobs/insights \
  --header 'x-api-key: <x-api-key>'

const options = {method: 'POST', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://api.hirebase.org/v2/jobs/insights', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hirebase.org/v2/jobs/insights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hirebase.org/v2/jobs/insights"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/insights")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "headline": {
    "total_count": 123,
    "sample_size": 123,
    "median_salary": 123,
    "salary_currency": "<string>",
    "pct_disclosing_salary": 123,
    "pct_remote": 123,
    "top_company": "<string>",
    "top_technology": "<string>",
    "dominant_experience_level": "<string>",
    "new_this_week": 123
  },
  "salary": {
    "count": 123,
    "avg": 123,
    "p25": 123,
    "p50": 123,
    "p75": 123,
    "p90": 123,
    "min": 123,
    "max": 123,
    "currency": "<string>",
    "histogram": [
      {}
    ],
    "fitted_normal": {}
  },
  "salary_by_level": [
    {}
  ],
  "salary_by_location_type": [
    {}
  ],
  "top_technologies": [
    {}
  ],
  "top_skills": [
    {}
  ],
  "top_benefits": [
    {}
  ],
  "top_companies": [
    {}
  ],
  "top_locations": [
    {}
  ],
  "level_breakdown": [
    {}
  ],
  "location_type_split": [
    {}
  ],
  "job_type_split": [
    {}
  ],
  "education_split": [
    {}
  ],
  "company_size_split": [
    {}
  ],
  "industry_split": [
    {}
  ],
  "subindustry_split": [
    {}
  ],
  "visa_sponsorship_rate": 123,
  "recruiter_agency_rate": 123,
  "yoe_median": 123,
  "freshness": {},
  "scores": {},
  "scores_by_level": [
    {}
  ],
  "cached": true,
  "generated_at": "<string>"
}

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

POST /v2/jobs/insights

Authentication

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.

object

Top-line KPIs for the cohort.

Show child attributes

integer

Total matching jobs in the cohort.

integer

Number of jobs used to compute the aggregates.

number

Median salary across disclosing jobs.

string

Currency for salary figures (e.g., "USD").

number

Percentage of jobs that disclose a salary.

number

Percentage of remote roles.

string

Most frequent company in the cohort.

string

Most frequent technology in the cohort.

string

Most common experience level.

integer

Number of jobs posted in the last 7 days.

object

Salary distribution for the cohort.

Show child attributes

number

Number of jobs contributing salary data.

number

Mean salary.

number

25th percentile salary.

number

Median (50th percentile) salary.

number

75th percentile salary.

number

90th percentile salary.

number

Minimum salary.

number

Maximum salary.

string

Currency (e.g., "USD").

object[]

Salary histogram buckets, each { lower, upper, count }.

object

Parameters of a fitted normal distribution, { mu, sigma }.

object[]

Salary distribution broken out by experience level. Each item: { key, count, p25, p50, p75 }.

object[]

Salary distribution broken out by work arrangement (Remote/Hybrid/In-Person). Each item: { key, count, p25, p50, p75 }.

object[]

Most common technologies. Each item: { key, count, percent }.

object[]

Most common skills. Each item: { key, count, percent }.

object[]

Most common benefits. Each item: { key, count, percent }.

object[]

Companies hiring most in the cohort. Each item: { company_name, company_slug, company_logo, count, percent }.

object[]

Most common locations. Each item: { label, region, country, count, percent }.

object[]

Distribution of jobs across experience levels.

object[]

Distribution across Remote / Hybrid / In-Person.

object[]

Distribution across job types (Full Time, Part Time, etc.).

object[]

Distribution across education requirements.

object[]

Distribution across company headcount buckets.

object[]

Distribution across industries.

object[]

Distribution across subindustries.

number

Percentage of jobs offering visa sponsorship.

number

Percentage of jobs posted by recruiting agencies.

number

Median required years of experience.

object

Recency metrics for the cohort (e.g., how recently jobs were posted).

object

Aggregate Hirebase quality scores for the cohort.

object[]

Aggregate quality scores broken out by experience level.

boolean

Whether the response was served from cache.

string

Timestamp the insights were generated (ISO 8601).

Example Request

curl -X POST "https://api.hirebase.org/v2/jobs/insights" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"job_titles":["Data Scientist"],"location_types":["Remote"],"days_ago":30}'

Example Response

{
  "headline": {
    "total_count": 500,
    "median_salary": 152477.5,
    "salary_currency": "USD",
    "pct_remote": 38.2,
    "top_technology": "Python",
    "dominant_experience_level": "Senior",
    "new_this_week": 64
  },
  "salary": {
    "count": 213,
    "p25": 120000,
    "p50": 152477,
    "p75": 190000,
    "p90": 230000,
    "currency": "USD",
    "histogram": [{ "lower": 80000, "upper": 100000, "count": 12 }],
    "fitted_normal": { "mu": 155000, "sigma": 42000 }
  },
  "top_technologies": [{ "key": "Python", "count": 427, "percent": 85.4 }],
  "cached": false,
  "generated_at": "2026-06-24T17:42:08.512Z"
}

Jobs API

Expired Jobs API

Hiring Manager API

Companies API

Insights API

Salary Benchmark API

Reference Data API

Resumes

Tasks API

Billing & Usage

Error Handling

Market Insights

Endpoint

Authentication

Request Body

Response

Example Request

Example Response

​Endpoint

​Authentication

​Request Body

​Response

​Example Request

​Example Response

Endpoint

Authentication

Request Body

Response

Example Request

Example Response