# Glassdoor Company Benefits API Documentation

<p><strong>Glassdoor Company Benefits API Documentation</strong> Get the benefit ratings of one Glassdoor company by category: for each benefit the average rating (1 to 5), the number of ratings, the number of comments and whether the employer verified the benefit, plus the total number of benefit reviews. These are aggregates only: the comment texts are not available. An unknown employer id 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_company_benefits](https://scrappa.co/docs/glassdoor-api/glassdoor_company_benefits)
- **API group:** Glassdoor API
- **Endpoint:** `GET https://scrappa.co/api/glassdoor/companies/benefits`

## 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 |
| --- | --- | --- | --- |
| `employer_id` | integer | Yes | Glassdoor employer id from the search or autocomplete endpoints. Example: 9079. |

## Example response

```json
{
    "data": {
        "company": "Google",
        "location": "United States",
        "categories": [
            {
                "id": 1,
                "name": "Insurance, Health & Wellness",
                "benefits": [
                    {
                        "id": 1,
                        "name": "Health Insurance",
                        "rating": 4.62,
                        "verified": true,
                        "ratings_count": 865,
                        "comments_count": 865
                    },
                    {
                        "id": 2,
                        "name": "Dental Insurance",
                        "rating": 4.47,
                        "verified": true,
                        "ratings_count": 154,
                        "comments_count": 154
                    },
                    {
                        "id": 4,
                        "name": "Flexible Spending Account (FSA)",
                        "rating": 4.54,
                        "verified": false,
                        "ratings_count": 24,
                        "comments_count": 24
                    }
                ]
            },
            {
                "id": 2,
                "name": "Financial & Retirement",
                "benefits": [
                    {
                        "id": 14,
                        "name": "Pension Plan",
                        "rating": 3.73,
                        "verified": false,
                        "ratings_count": 15,
                        "comments_count": 15
                    },
                    {
                        "id": 13,
                        "name": "401K Plan",
                        "rating": 4.72,
                        "verified": true,
                        "ratings_count": 401,
                        "comments_count": 401
                    },
                    {
                        "id": 20,
                        "name": "Retirement Plan",
                        "rating": 4.57,
                        "verified": true,
                        "ratings_count": 221,
                        "comments_count": 221
                    }
                ]
            }
        ],
        "employer_id": 9079,
        "total_benefit_reviews": 8646
    },
    "meta": {
        "billable": true,
        "endpoint_family": "company_benefits"
    },
    "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 | Company Not Found | The Glassdoor employer id does not exist. 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 | Upstream Blocked | Glassdoor blocked every try. 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)
