▣ ARTIFICIAL INTELLIGENCE · HR

Global Salary Benchmark API

What it does

Salary Range Estimator helps you estimate a market salary range for a candidate from a job title, location, and resume content. Send those three inputs, and get back a market context string plus an estimated range with min, max, and currency.

Use it when you need a fast compensation benchmark during hiring, offer planning, or recruiter screening. For example, you can compare a Staff Software Engineer candidate in New York, NY against current market conditions before setting an offer band or reviewing an internal requisition.

The response is intentionally compact: marketContext gives you a short explanation of the market conditions behind the estimate, and estimatedRange provides the numeric range in the reported currency. That makes it easy to feed into internal HR workflows, dashboards, or a compensation review step without extra parsing.

Salary Range Estimator is a good fit for products that need lightweight hiring intelligence without building your own compensation model.

POST

Estimate the market salary range for a candidate

https://api.eu.apyverse.com/namastesumalya/estimate-market-salary-range

QUICKSTART

GUIDE

Quickstart

Estimate a market salary range for a role using the job title, location, and resume details.

curl -X POST "https://api.eu.apyverse.com/namastesumalya/estimate-market-salary-range" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jobTitle":"Staff Software Engineer","location":"New York, NY","resumeContent":"Candidate experience and skills..."}'

What you'll get back

Returns a JSON object with optional marketContext and estimatedRange fields. marketContext is a string, and estimatedRange is an object with min, max, and currency fields describing the estimated salary range.

{
  "marketContext": "NYC Fintech salaries for Staff roles with HFT experience are at an all-time high.",
  "estimatedRange": {
    "min": 250000,
    "max": 450000,
    "currency": "USD"
  }
}

TRY ITLIVE · 750 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Estimates a candidate’s market salary range from the provided job title, location, and resume content. The response returns a market context string and an estimated salary range object.

Request Body

Parameter	Type	Mandatory	Description
jobTitle	String	No	The candidate’s job title.
location	String	No	The candidate’s location.
resumeContent	String	No	The candidate’s resume content.

Response

Returns a JSON object with a marketContext string field and an estimatedRange object field. estimatedRange contains min and max integer fields and a currency string field.

Parameter	Type	Mandatory	Description
marketContext	String	No	Context about the market conditions used to estimate the range.
estimatedRange	Object	No	The estimated salary range object.
estimatedRange.min	Integer	No	The minimum estimated salary.
estimatedRange.max	Integer	No	The maximum estimated salary.
estimatedRange.currency	String	No	The currency of the estimated range.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.