# Glassdoor Salary Estimate API Documentation

<p><strong>Glassdoor Salary Estimate API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/glassdoor-api/glassdoor_salary_estimate](https://scrappa.co/docs/glassdoor-api/glassdoor_salary_estimate)
- **API group:** Glassdoor API
- **Endpoint:** `GET https://scrappa.co/api/glassdoor/salaries/estimate`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `job_title` | string | Yes | Job title, 1 to 100 characters. Example: software engineer. |
| `country_id` | integer | No | Glassdoor country id from the location search endpoint. Example: 1 (United States). |
| `state_id` | integer | No | Glassdoor state id from the location search endpoint. |
| `metro_id` | integer | No | Glassdoor metro area id from the location search endpoint. |
| `city_id` | integer | No | Glassdoor city id from the location search endpoint (the location_id of a CITY). |
| `years_of_experience` | string | No | One of LESS_THAN_ONE, ONE_TO_THREE, FOUR_TO_SIX, SEVEN_TO_NINE, TEN_TO_FOURTEEN. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required or invalid query parameter. No upstream call is made. This response is not billable. |
| 404 | Estimate Not Found | Glassdoor has no estimate for this job title and location. This response is not billable. |
| 503 | Invalid Source Response | Glassdoor answered with a shape that no longer matches the documented contract. This response is not billable. |
| 503 | Service Unavailable | Glassdoor could not be reached. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)