# Das Oertliche Business Profile API Documentation

Get one public Das Oertliche business by the id from the search: name, categories, rating, review count, address, phones, fax, e-mail, website, opening hours per weekday, photos and the reviews the page shows (date as ISO 8601). Private person listings answer 404. Costs 1 credit. Unknown ids and failed requests are free.

- **Documentation:** [https://scrappa.co/docs/dasoertliche-api/dasoertliche_business](https://scrappa.co/docs/dasoertliche-api/dasoertliche_business)
- **API group:** Das Oertliche API
- **Endpoint:** `GET https://scrappa.co/api/dasoertliche/business`

## 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 |
| --- | --- | --- | --- |
| `id` | string | Yes | Listing id from the search results. A Das Oertliche listing link is accepted too. Example: Abschnitt-Friseur-Berlin-Mariendorf-Tauernallee. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/dasoertliche/business?id=Abschnitt-Friseur-Berlin-Mariendorf-Tauernallee"
```

## Example response

```json
{
    "success": true,
    "data": {
        "business": {
            "id": "Abschnitt-Friseur-Berlin-Mariendorf-Tauernallee",
            "name": "Abschnitt Friseur",
            "url": "https://www.dasoertliche.de/Themen/Abschnitt-Friseur-Berlin-Mariendorf-Tauernallee",
            "categories": [
                "Friseursalons"
            ],
            "address": {
                "street": "Tauernallee",
                "house_number": "4",
                "postal_code": "12107",
                "city": "Berlin",
                "district": "Mariendorf",
                "country": "DE",
                "formatted": "Tauernallee 4, 12107 Berlin"
            },
            "coordinates": null,
            "phone": "030 7 41 19 04",
            "phones": [
                "030 7 41 19 04"
            ],
            "fax": null,
            "email": null,
            "website": null,
            "rating": 4.5,
            "review_count": 5,
            "hours": [
                {
                    "day": "monday",
                    "opens": "09:00",
                    "closes": "18:00"
                },
                {
                    "day": "saturday",
                    "opens": "08:00",
                    "closes": "14:00"
                }
            ],
            "photos": [
                "https://www.golocal.de/media/672d8f9388422368139af4f1e747cdc4/1600/b4e3f6354c7193f2.jpg"
            ],
            "reviews": [
                {
                    "author": "KK1976",
                    "rating": 5,
                    "text": "Sehr netter Service.",
                    "date": "2022-07-27",
                    "source": "golocal"
                }
            ]
        }
    },
    "meta": {
        "endpoint_family": "business_detail",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id is missing or not a Das Oertliche listing id. This response is not billable. |
| 404 | Business Not Found | No business has this id, or the listing is private. This response is not billable. |
| 502 | Upstream Unavailable | Das Oertliche did not answer with usable data. 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)