# Comparably Company Search API Documentation

<p>Resolve one exact company name to its public Comparably slug by verifying one company page. A success carries the verified slug, its Comparably url and source company_page. Use the slug with the company, culture, salaries and reviews endpoints. This is exact-name slug resolution, not a keyword search. A name with no public page returns 404 and is not billed. 45 credits per successful request. Failed requests are free. 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_company_search](https://scrappa.co/docs/comparably-api/comparably_company_search)
- **API group:** Comparably API
- **Endpoint:** `GET https://scrappa.co/api/comparably/companies/search`

## 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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Exact company name, for example stripe, netflix or google. |

## Example response

```json
{
    "data": {
        "source": "company_page",
        "companies": [
            {
                "url": "https://www.comparably.com/companies/stripe",
                "slug": "stripe"
            }
        ]
    },
    "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)
