apyhub
Back
▣ ARTIFICIAL INTELLIGENCE · HR

Global Salary Benchmark API

What it does

Salary Range Estimator estimates a market salary band 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 to benchmark compensation during recruiting, pre-screening, or offer planning. The response is designed to be easy to plug into hiring workflows: one field explains the market context, and one structured object gives the salary range in a standard currency format.

Salary Range Estimator is useful for internal comp checks, recruiter tooling, and applicant-facing guidance where you want a fast estimate grounded in the role, location, and experience described in the resume. Keep in mind that the output is an estimate, not a contractual offer or payroll record.

POST
Estimate the market salary range for a candidate
https://api.eu.apyhub.com/namastesumalya/estimate-market-salary-range

QUICKSTART

GUIDE

Quickstart

Estimate a market salary range for a job by sending the job title, location, and resume content in a JSON request body.

curl -X POST "https://api.eu.apyhub.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 two top-level fields: marketContext is a string describing the salary market context, and estimatedRange is an object containing min and max integers plus a currency string.

{
  "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
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*

About this endpoint

What it does

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

Request Body

ParameterTypeDescription
jobTitleStringThe candidate’s job title.
locationStringThe candidate’s location.
resumeContentStringThe candidate’s resume or experience summary text.

Response

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

ParameterTypeDescription
marketContextStringA textual summary of the market factors used to estimate the range.
estimatedRangeObjectThe estimated salary range object containing min, max, and currency.
estimatedRange.minIntegerThe lower bound of the estimated salary range.
estimatedRange.maxIntegerThe upper bound of the estimated salary range.
estimatedRange.currencyStringThe currency code for the estimated range.
▣ 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.

Similar APIs

Closest matches in the catalog based on this service.

CALLResume Parser APISharpAPICALLResume/CV Job Match Score APISharpAPICALLResume Optimizer (ATS) APISumalya APIsCALLResume Screening APISumalya APIs

From the blog

Reads that touch this API.

Top 5 Free AI Resume Parsers for Recruiters in 2025Sep 10, 2026Resume Parsing API: When You Need a Parser and When You Need a PipelineSep 10, 20267 AI Hiring APIs to Automate Recruitment, From Job Post to Offer (2026)Aug 5, 2026Top 5 Rank Tracking APIs to Build Your Own SEO Monitoring StackAug 24, 2026