Salary Benchmark

curl --request POST \
  --url https://api.hirebase.org/v2/jobs/salary-benchmark \
  --header 'Content-Type: application/json' \
  --data '
{
  "public_url": "<string>",
  "job_title": "<string>",
  "job_titles": [
    "<string>"
  ],
  "yoe_range": {},
  "description": "<string>",
  "salary_range": {},
  "geo_locations": [
    {}
  ],
  "location_types": [
    "<string>"
  ],
  "industry": [
    "<string>"
  ],
  "experience_levels": [
    "<string>"
  ],
  "days_ago": 123,
  "notify": true
}
'

import requests

url = "https://api.hirebase.org/v2/jobs/salary-benchmark"

payload = {
    "public_url": "<string>",
    "job_title": "<string>",
    "job_titles": ["<string>"],
    "yoe_range": {},
    "description": "<string>",
    "salary_range": {},
    "geo_locations": [{}],
    "location_types": ["<string>"],
    "industry": ["<string>"],
    "experience_levels": ["<string>"],
    "days_ago": 123,
    "notify": True
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    public_url: '<string>',
    job_title: '<string>',
    job_titles: ['<string>'],
    yoe_range: {},
    description: '<string>',
    salary_range: {},
    geo_locations: [{}],
    location_types: ['<string>'],
    industry: ['<string>'],
    experience_levels: ['<string>'],
    days_ago: 123,
    notify: true
  })
};

fetch('https://api.hirebase.org/v2/jobs/salary-benchmark', 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/salary-benchmark",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'public_url' => '<string>',
    'job_title' => '<string>',
    'job_titles' => [
        '<string>'
    ],
    'yoe_range' => [
        
    ],
    'description' => '<string>',
    'salary_range' => [
        
    ],
    'geo_locations' => [
        [
                
        ]
    ],
    'location_types' => [
        '<string>'
    ],
    'industry' => [
        '<string>'
    ],
    'experience_levels' => [
        '<string>'
    ],
    'days_ago' => 123,
    'notify' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.hirebase.org/v2/jobs/salary-benchmark"

	payload := strings.NewReader("{\n  \"public_url\": \"<string>\",\n  \"job_title\": \"<string>\",\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"yoe_range\": {},\n  \"description\": \"<string>\",\n  \"salary_range\": {},\n  \"geo_locations\": [\n    {}\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"experience_levels\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"notify\": true\n}")

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

	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hirebase.org/v2/jobs/salary-benchmark")
  .header("Content-Type", "application/json")
  .body("{\n  \"public_url\": \"<string>\",\n  \"job_title\": \"<string>\",\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"yoe_range\": {},\n  \"description\": \"<string>\",\n  \"salary_range\": {},\n  \"geo_locations\": [\n    {}\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"experience_levels\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"notify\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/salary-benchmark")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"public_url\": \"<string>\",\n  \"job_title\": \"<string>\",\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"yoe_range\": {},\n  \"description\": \"<string>\",\n  \"salary_range\": {},\n  \"geo_locations\": [\n    {}\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"experience_levels\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"notify\": true\n}"

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

{
  "id": "79a854ab-0543-478f-8bc5-f7261ce42fda",
  "type": "salary_benchmark",
  "state": "queued",
  "progress": 0
}

POST

jobs

salary-benchmark

Salary Benchmark

curl --request POST \
  --url https://api.hirebase.org/v2/jobs/salary-benchmark \
  --header 'Content-Type: application/json' \
  --data '
{
  "public_url": "<string>",
  "job_title": "<string>",
  "job_titles": [
    "<string>"
  ],
  "yoe_range": {},
  "description": "<string>",
  "salary_range": {},
  "geo_locations": [
    {}
  ],
  "location_types": [
    "<string>"
  ],
  "industry": [
    "<string>"
  ],
  "experience_levels": [
    "<string>"
  ],
  "days_ago": 123,
  "notify": true
}
'

import requests

url = "https://api.hirebase.org/v2/jobs/salary-benchmark"

payload = {
    "public_url": "<string>",
    "job_title": "<string>",
    "job_titles": ["<string>"],
    "yoe_range": {},
    "description": "<string>",
    "salary_range": {},
    "geo_locations": [{}],
    "location_types": ["<string>"],
    "industry": ["<string>"],
    "experience_levels": ["<string>"],
    "days_ago": 123,
    "notify": True
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    public_url: '<string>',
    job_title: '<string>',
    job_titles: ['<string>'],
    yoe_range: {},
    description: '<string>',
    salary_range: {},
    geo_locations: [{}],
    location_types: ['<string>'],
    industry: ['<string>'],
    experience_levels: ['<string>'],
    days_ago: 123,
    notify: true
  })
};

fetch('https://api.hirebase.org/v2/jobs/salary-benchmark', 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/salary-benchmark",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'public_url' => '<string>',
    'job_title' => '<string>',
    'job_titles' => [
        '<string>'
    ],
    'yoe_range' => [
        
    ],
    'description' => '<string>',
    'salary_range' => [
        
    ],
    'geo_locations' => [
        [
                
        ]
    ],
    'location_types' => [
        '<string>'
    ],
    'industry' => [
        '<string>'
    ],
    'experience_levels' => [
        '<string>'
    ],
    'days_ago' => 123,
    'notify' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.hirebase.org/v2/jobs/salary-benchmark"

	payload := strings.NewReader("{\n  \"public_url\": \"<string>\",\n  \"job_title\": \"<string>\",\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"yoe_range\": {},\n  \"description\": \"<string>\",\n  \"salary_range\": {},\n  \"geo_locations\": [\n    {}\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"experience_levels\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"notify\": true\n}")

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

	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hirebase.org/v2/jobs/salary-benchmark")
  .header("Content-Type", "application/json")
  .body("{\n  \"public_url\": \"<string>\",\n  \"job_title\": \"<string>\",\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"yoe_range\": {},\n  \"description\": \"<string>\",\n  \"salary_range\": {},\n  \"geo_locations\": [\n    {}\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"experience_levels\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"notify\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/salary-benchmark")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"public_url\": \"<string>\",\n  \"job_title\": \"<string>\",\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"yoe_range\": {},\n  \"description\": \"<string>\",\n  \"salary_range\": {},\n  \"geo_locations\": [\n    {}\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"experience_levels\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"notify\": true\n}"

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

{
  "id": "79a854ab-0543-478f-8bc5-f7261ce42fda",
  "type": "salary_benchmark",
  "state": "queued",
  "progress": 0
}

Queues a posted-salary benchmark for a role. Pass either a public job-posting URL or the role’s attributes; the API resolves comparable postings from the last days_ago days and writes a report onto a task you poll for the result.

Requires authentication. Each request bills 1 unit of m_salary_benchmarks: 3 per month on Free, 25 per month on API plans (then

0.25 each), 500 per month on Pro (then

0.05 each). See plan allowances.

Endpoint

POST /v2/jobs/salary-benchmark

Request Body

Either public_url or job_title is required. public_url takes precedence over the manual fields.

string

Public job-posting URL to benchmark. When provided, the role attributes are extracted from the posting.

string

Primary job title when no URL is provided.

string[]

Additional titles in the same occupational area to widen the comparison set.

object

Years-of-experience band, e.g. {"min": 5, "max": 8}. yoe is accepted as an alias.

string

Job description or notes used to expand the query.

object

Proposed posted range to rank against the market, e.g. {"min": 160000, "max": 190000, "currency": "USD", "period": "yearly"}. When provided, the report includes where it sits as a percentile.

object[]

Locations to compare within, e.g. [{"city": "Austin", "region": "Texas", "country": "United States"}]. Country-only entries are accepted.

string[]

Remote, Hybrid, and/or In-Person.

string[]

Industry filter — values from Get Industries.

string[]

Experience levels to include.

number

default:"90"

Lookback window in days (1–365).

boolean

default:"false"

Send an email when the report is ready.

Response

Returns a task object (id, type: "salary_benchmark", state, progress). Poll GET /v2/tasks/{task_id} until state is finished; the report is in the task’s result.

object

Market distribution for comparable postings: count (sample size) and percentiles such as p50 (median).

object

Confidence in the benchmark, including a letter grade driven by sample size and match quality.

object | null

Present when salary_range was supplied: the proposed min/max and the percentile the range sits at in the market distribution.

Example

curl -X POST 'https://api.hirebase.org/v2/jobs/salary-benchmark' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "job_title": "Senior Software Engineer",
    "yoe_range": {"min": 5, "max": 10},
    "geo_locations": [{"country": "United States"}],
    "salary_range": {"min": 160000, "max": 190000, "currency": "USD", "period": "yearly"},
    "days_ago": 90
  }'

from hirebase import SalaryBenchmarkRequest

task = client.jobs.salary_benchmark(SalaryBenchmarkRequest(
    job_title="Senior Software Engineer",
    yoe_range={"min": 5, "max": 10},
    geo_locations=[{"country": "United States"}],
    days_ago=90,
))
success, report = client.tasks.poll(task, interval=5, timeout=900)
market = report["market"]["salary"]
print(market["count"], "postings, median", market["p50"], "confidence", report["confidence"]["grade"])

{
  "id": "79a854ab-0543-478f-8bc5-f7261ce42fda",
  "type": "salary_benchmark",
  "state": "queued",
  "progress": 0
}

Reports are computed from posted salary ranges in Hirebase’s job data, not from offers or survey data. Treat thin samples (low count, low confidence grade) as directional.

Jobs API

Expired Jobs API

Hiring Manager API

Companies API

Insights API