# Comparably Reviews API Documentation

<p>Page through public employee reviews of one company. Each review carries the question, text, masked author, department, rating, ISO 8601 date and a category when the page provides one. Script and page data text is dropped. Question and department are clean labels or null. Summary blurbs and stray prefixes are removed and HTML entities are decoded. Coverage is partial. 70 credits per successful request. Failed tries are never billed. Company, salaries and reviews routes show their credit cost. No client rate limit.</p>

- **Documentation:** [https://scrappa.co/docs/comparably-api/comparably_reviews](https://scrappa.co/docs/comparably-api/comparably_reviews)
- **API group:** Comparably API
- **Endpoint:** `GET https://scrappa.co/api/comparably/companies/reviews`

## 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 |
| --- | --- | --- | --- |
| `slug` | string | Yes | Company slug from search or sitemap. |
| `page` | integer | No | 1-based page, default 1. |

## Example response

```json
{
    "data": {
        "page": 1,
        "reviews": [
            {
                "text": "Good culture",
                "rating": 4,
                "department": "Engineering"
            }
        ]
    },
    "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 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)
