# Blind Salaries API Documentation

<p>Read public salary submissions for one company and country. Each row carries title, total compensation, base salary, bonus, equity, USD currency and an ISO 8601 date. The country slug is checked before any lookup. The only supported slug is united-states. An unsupported slug returns 422 and is not billed. Failed requests are never billed. A valid answer with no rows is a successful response.</p>

- **Documentation:** [https://scrappa.co/docs/blind-api/blind_salaries](https://scrappa.co/docs/blind-api/blind_salaries)
- **API group:** Blind API
- **Endpoint:** `GET https://scrappa.co/api/blind/companies/salaries`

## 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 |
| --- | --- | --- | --- |
| `alias` | string | Yes | Company url alias from search. |
| `country` | string | Yes | Supported slug: united-states. Other slugs return 422. |

## Example response

```json
{
    "data": {
        "salaries": [
            {
                "title": "Software Engineer",
                "currency": "USD",
                "base_salary": 150000,
                "total_compensation": 180000
            }
        ]
    },
    "meta": {
        "billable": true
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. No upstream call is made. Not billable. |
| 404 | Not Found | The requested company or review does not exist. Not billable. |
| 503 | Service Unavailable | The upstream source could not be read. 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)
