# Booli Area Autocomplete API

<p>Find the area ids that the search endpoints take, from `GET /api/booli/areas`. Send `query` for autocomplete (municipalities, counties, districts and streets with their parent) or `ids` to resolve known area ids to names and types. Send exactly one of the two.</p>

- **Documentation:** [https://scrappa.co/docs/booli-api/booli_areas](https://scrappa.co/docs/booli-api/booli_areas)
- **API group:** Booli API
- **Endpoint:** `GET https://scrappa.co/api/booli/areas`

## 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 | No | Text to autocomplete, for example Stockholm. Send this or ids |
| `ids` | string | No | Comma-separated area ids to resolve, for example 1,2. Send this or query |

## Example response

```json
{
    "data": {
        "areas": [],
        "count": 10,
        "query": "stockholm"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | The id, area or home does not exist. This response is not billable. |  |
|  | A parameter or filter is missing or invalid. This response is not billable. |  |
|  | Booli is temporarily unavailable. Retry the request. 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)