Skip to content
Scrappa Get API key
Glassdoor API 1 credit/request

Glassdoor Salary Estimate API Documentation

GET https://scrappa.co/api/glassdoor/salaries/estimate

Glassdoor Salary Estimate API Documentation Estimate pay for a job title independent of an employer, optionally narrowed by location and years of experience. The result has base pay, additional pay and total pay as percentiles (p1, p10, p25, p50, p75, p90, p99 where Glassdoor has enough data; p50 is the median), the currency, the pay period, a confidence label, the number of salaries behind the estimate and the estimate source. Glassdoor publishes percentiles only, so there is no minimum or maximum value. Get the location ids from the location search endpoint. A title or location without an estimate returns a 404 error that is not billed. Costs 1 credit per successful request. Failed requests are not billed.

Glassdoor Salary Estimate API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/glassdoor/salaries/estimate
Auth header
x-api-key
Cost
1 credit/request
job_title = example
Response preview
200 OK
{
    "data": {
        "query": {
            "city_id": 1132348,
            "job_title": "software engineer",
            "country_id": 1,
            "years_of_experience": "FOUR_TO_SIX"
        },
        "estimate": {
            "source": {
                "name": "V3",
                "version": "v57",
                "updated_at": "2026-10-08T23:59:59Z"
            },
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

5 optional filters available.

job_title string Required

Job title, 1 to 100 characters. Example: software engineer.

Example value example
country_id integer Optional

Glassdoor country id from the location search endpoint. Example: 1 (United States).

Example value 1234567890
state_id integer Optional

Glassdoor state id from the location search endpoint.

Example value 1234567890
metro_id integer Optional

Glassdoor metro area id from the location search endpoint.

Example value 1234567890
city_id integer Optional

Glassdoor city id from the location search endpoint (the location_id of a CITY).

Example value 1234567890
years_of_experience string Optional

One of LESS_THAN_ONE, ONE_TO_THREE, FOUR_TO_SIX, SEVEN_TO_NINE, TEN_TO_FOURTEEN.

Example value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "query": {
            "city_id": 1132348,
            "job_title": "software engineer",
            "country_id": 1,
            "years_of_experience": "FOUR_TO_SIX"
        },
        "estimate": {
            "source": {
                "name": "V3",
                "version": "v57",
                "updated_at": "2026-10-08T23:59:59Z"
            },
            "currency": "USD",
            "location": "New York, NY",
            "job_title": "Software Engineer",
            "confidence": "CONFIDENT",
            "pay_period": "ANNUAL",
            "job_title_id": 4279,
            "salaries_count": 50872,
            "base_pay_percentiles": {
                "p10": 81765.98,
                "p25": 103209.03,
                "p50": 133719.16,
                "p75": 173248.54,
                "p90": 218682.8
            },
            "total_pay_percentiles": {
                "p10": 105963.09,
                "p25": 134498.4,
                "p50": 175438.32,
                "p75": 231655.36,
                "p90": 295028.86
            },
            "additional_pay_percentiles": {
                "p10": 24197.11,
                "p25": 31289.37,
                "p50": 41719.16,
                "p75": 58406.82,
                "p90": 76346.06
            }
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "salary_estimate"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required or invalid query parameter. No upstream call is made. This response is not billable.

{
    "errors": {
        "years_of_experience": [
            "years_of_experience must be one of: LESS_THAN_ONE, ONE_TO_THREE, FOUR_TO_SIX, SEVEN_TO_NINE, TEN_TO_FOURTEEN."
        ]
    },
    "message": "The request validation failed"
}
404

Estimate Not Found

Glassdoor has no estimate for this job title and location. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "salary_estimate"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "No Glassdoor salary estimate was found for this job title and location."
    },
    "success": false
}
503

Invalid Source Response

Glassdoor answered with a shape that no longer matches the documented contract. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "salary_estimate"
    },
    "error": {
        "code": "PARSER_DRIFT",
        "message": "The Glassdoor API is temporarily unavailable. Please retry."
    },
    "success": false
}
503

Service Unavailable

Glassdoor could not be reached. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "salary_estimate"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "The Glassdoor API is temporarily unavailable. Please retry."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.