# Gelbe Seiten Business Profile API Documentation

Get one public Gelbe Seiten business by the id from the search: name, description, categories, services, rating, review count, address, coordinates, phones, fax, e-mail, website, opening hours per weekday, images, logo and the reviews the page shows (date as ISO 8601). Costs 1 credit. Unknown ids and failed requests are free.

- **Documentation:** [https://scrappa.co/docs/gelbeseiten-api/gelbeseiten_business](https://scrappa.co/docs/gelbeseiten-api/gelbeseiten_business)
- **API group:** Gelbe Seiten API
- **Endpoint:** `GET https://scrappa.co/api/gelbeseiten/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 | Business id from the search results (a UUID). A Gelbe Seiten business link is accepted too. Example: 9ae83a87-cd19-433c-b348-cb26fc3b9887. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/gelbeseiten/business?id=9ae83a87-cd19-433c-b348-cb26fc3b9887"
```

## Example response

```json
{
    "success": true,
    "data": {
        "business": {
            "id": "9ae83a87-cd19-433c-b348-cb26fc3b9887",
            "name": "Domino's Pizza Berlin Mitte",
            "url": "https://www.gelbeseiten.de/gsbiz/9ae83a87-cd19-433c-b348-cb26fc3b9887",
            "description": "Pizza, Pasta, Salat und mehr. Lieferung und Abholung!",
            "categories": [
                "Pizzeria"
            ],
            "services": [
                "Pizza",
                "Pasta",
                "Delivery"
            ],
            "rating": 3,
            "review_count": 1,
            "address": {
                "street": "Schumannstra\u00dfe 19",
                "postal_code": "10117",
                "city": "Berlin",
                "country": "DE",
                "formatted": "Schumannstra\u00dfe 19, 10117 Berlin"
            },
            "coordinates": {
                "lat": 52.523823,
                "lon": 13.379811
            },
            "phone": "+493027572410",
            "phones": [
                "+493027572410"
            ],
            "fax": null,
            "email": "info@dominos.de",
            "website": "https://www.dominos.de",
            "hours": [
                {
                    "day": "monday",
                    "opens": "11:00",
                    "closes": "23:00"
                }
            ],
            "images": [
                "https://a.mktgcdn.com/p/nVE-Q7U05wqtfh_sths-d31miBqlVgdLy7jMtwKgqU8/800x600.jpg"
            ],
            "logo": "https://a.mktgcdn.com/p/VkrHZDqZzFBncnhLOrGbTlM11Gt6NFCjtCtlw66ecV4/1080x1080.png",
            "reviews": [
                {
                    "author": "Hans Markus BenutzerIn",
                    "rating": 3,
                    "text": "Die Pizza war okay.",
                    "date": "2021-01-31",
                    "source": "golocal"
                }
            ],
            "updated_at": "2026-11-08"
        }
    },
    "meta": {
        "endpoint_family": "business_detail",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id is missing or not a Gelbe Seiten business id. This response is not billable. |
| 404 | Business Not Found | No business has this id. This response is not billable. |
| 502 | Upstream Unavailable | Gelbe Seiten 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)