# Fresha Salon Search API Documentation

<p>Returns public salons for a treatment and city with rating, review count, address, coordinates, price from and categories. Each result carries an id accepted unchanged by the venue and reviews endpoints.</p>

- **Documentation:** [https://scrappa.co/docs/fresha-api/fresha_search](https://scrappa.co/docs/fresha-api/fresha_search)
- **API group:** Fresha API
- **Endpoint:** `GET https://scrappa.co/api/fresha/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 | Only page 1 is available; page 2 or higher returns 422 |

## Example response

```json
{
    "data": {
        "results": [
            {
                "id": "example-salon",
                "name": "Salon Name",
                "rating": 4.9,
                "address": "Street 1, Berlin",
                "currency": "EUR",
                "latitude": 52.52,
                "longitude": 13.4,
                "categories": [
                    "Hair"
                ],
                "price_from": 40,
                "review_count": 7043
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "fresha_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)
