# Treatwell Salon Search API Documentation

<p>Public salons in the requested city for a treatment, with rating, review count, address, price from and categories. Ids work in venue and reviews. Returns 422 when no public venue matches the treatment and city.</p>

- **Documentation:** [https://scrappa.co/docs/treatwell-api/treatwell_search](https://scrappa.co/docs/treatwell-api/treatwell_search)
- **API group:** Treatwell API
- **Endpoint:** `GET https://scrappa.co/api/treatwell/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 |
| --- | --- | --- | --- |
| `treatment` | string | Yes | Treatment or service, for example Balayage |
| `location` | string | Yes | City, for example Berlin |
| `page` | string | No | Page number, default 1 |

## Example response

```json
{
    "data": {
        "results": [
            {
                "id": "12345",
                "name": "Salon Name",
                "rating": 4.7,
                "address": "Street 1, Berlin",
                "currency": "EUR",
                "latitude": 52.52,
                "longitude": 13.4,
                "categories": [
                    "Hair"
                ],
                "price_from": 35,
                "review_count": 321
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "treatwell_search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Check the treatment and location parameters |  |
| 503 | The data source is temporarily unavailable |  |

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