# Das Oertliche Business Search API Documentation

Search public Das Oertliche business listings by term and place (city or postal code), 25 per page: id, name, address, phone, website, public e-mail, coordinates, rating and review count when present. Private person listings are never returned and are counted in excluded_private_listings. The total is the full count of the place search and includes private listings. Costs 1 credit. Failed requests are free.

- **Documentation:** [https://scrappa.co/docs/dasoertliche-api/dasoertliche_search](https://scrappa.co/docs/dasoertliche-api/dasoertliche_search)
- **API group:** Das Oertliche API
- **Endpoint:** `GET https://scrappa.co/api/dasoertliche/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 | What to look for, 2 to 100 characters. Example: Friseur. |
| `location` | string | Yes | City or postal code, 2 to 100 characters. Example: Berlin or 10115. |
| `page` | integer | No | Page number, starting at 1. Each page holds up to 25 listings. A page past the end returns an empty list. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/dasoertliche/search?query=Friseur&location=Berlin"
```

## Example response

```json
{
    "success": true,
    "data": {
        "query": "Friseur",
        "location": "Berlin",
        "page": 1,
        "per_page": 25,
        "total": 1248,
        "has_more": true,
        "next_page": 2,
        "excluded_private_listings": 0,
        "results": [
            {
                "id": "Dream-Team-Inh-Melanie-Golisch-Berlin-Baumschulenweg-Kiefholzstr",
                "name": "Dream Team Inh. Melanie Golisch",
                "url": "https://www.dasoertliche.de/Themen/Dream-Team-Inh-Melanie-Golisch-Berlin-Baumschulenweg-Kiefholzstr",
                "address": {
                    "street": "Kiefholzstr.",
                    "house_number": "270",
                    "postal_code": "12437",
                    "city": "Berlin",
                    "formatted": "Kiefholzstr. 270, 12437 Berlin"
                },
                "phone": "030 47 36 36 57",
                "website": null,
                "email": "mausefaust@arcor.de",
                "coordinates": {
                    "lat": 52.467457,
                    "lon": 13.485116
                },
                "rating": 4.5,
                "review_count": 3
            }
        ]
    },
    "meta": {
        "endpoint_family": "business_search",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter is missing or invalid. This response is not billable. |
| 502 | Upstream Unavailable | Das Oertliche did not answer with usable data, or the place could not be resolved. This response is not billable. Retry later. |

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