# ZipRecruiter Salary Estimates API Documentation

<p><strong>ZipRecruiter Salary Estimates</strong> returns the pay distribution for a job title, for the whole country or for one city: the 10th, 25th, 75th and 90th percentile, the median, the average and the national average. Each value comes for the intervals ZipRecruiter shows (hour, week, month, year), so the unit is always clear. The answer also has a distribution of pay buckets, the update date and related job titles with their pay. Salary estimates are for the US only.</p><p>A title without a salary page returns 404. A request costs 1 credit. A failed request is not charged.</p>

- **Documentation:** [https://scrappa.co/docs/ziprecruiter-api/ziprecruiter_salary](https://scrappa.co/docs/ziprecruiter-api/ziprecruiter_salary)
- **API group:** ZipRecruiter API
- **Endpoint:** `GET https://scrappa.co/api/ziprecruiter/salary`

## 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 |
| --- | --- | --- | --- |
| `title` | string | Yes | Job title, for example Registered Nurse. |
| `city` | string | No | City name. Send it together with state. |
| `state` | string | No | Two letter US state code, for example TX. Send it together with city. |
| `country` | string | No | us (the only value). Salary estimates cover the US only. |

## Example response

```json
{
    "data": {
        "title": "Registered Nurse",
        "amounts": {
            "hour": {
                "p10": 26.68,
                "p25": 31.2,
                "p75": 49.57,
                "p90": 62.41,
                "median": 39.07,
                "average": 41.86,
                "national_average": 42.24
            },
            "year": {
                "p10": 55494,
                "p25": 64900,
                "p75": 103100,
                "p90": 129817,
                "median": 81259,
                "average": 87074,
                "national_average": 87868
            }
        },
        "updated": "October 26 2026",
        "currency": "USD",
        "location": "Austin, TX, US",
        "distribution": [
            {
                "from": 15360,
                "share": 0.0069
            },
            {
                "from": 27252,
                "share": 0.0048
            },
            {
                "from": 39639,
                "share": 0.0464
            }
        ],
        "related_titles": [
            {
                "title": "Rn Clinical Informatics",
                "annual": 142926,
                "hourly": 68.71,
                "weekly": 2748,
                "monthly": 11910
            },
            {
                "title": "Rn Clinical Auditor",
                "annual": 98820,
                "hourly": 47.51,
                "weekly": 1900,
                "monthly": 8235
            },
            {
                "title": "Rn Case Manager Supervisor",
                "annual": 98000,
                "hourly": 47.12,
                "weekly": 1884,
                "monthly": 8166
            },
            {
                "title": "Cvs Rn",
                "annual": 91969,
                "hourly": 44.22,
                "weekly": 1768,
                "monthly": 7664
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "salary"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | ZipRecruiter has no salary page for this title. This response is not billable. |
| 422 | Invalid Request | A parameter is missing or has the wrong format. This response is not billable. |
| 503 | Upstream Unavailable | ZipRecruiter could not be reached, or the page did not match the request. This response is not billable and is retryable. |

## 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)