Salary Range Estimator — estimate market pay bands

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.

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 "http://localhost:8080/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"
  }
}

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

Parameter	Type	Mandatory	Description
jobTitle	String	Yes	The candidate’s job title.
location	String	Yes	The candidate’s location.
resumeContent	String	Yes	The 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.

Parameter	Type	Mandatory	Description
marketContext	String	No	A textual summary of the market factors used to estimate the range.
estimatedRange	Object	No	The estimated salary range object containing `min`, `max`, and `currency`.
estimatedRange.min	Integer	No	The lower bound of the estimated salary range.
estimatedRange.max	Integer	No	The upper bound of the estimated salary range.
estimatedRange.currency	String	No	The currency code for the estimated range.

Body

Name

Type

Description

bodyREQUIRED

object

—

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return