# 11880 Business Search API Documentation

Search public 11880 businesses by term and city or postal code: id, name, rating, review count, address, phone, coordinates and image URL. The search page does not publish categories, websites, hours or descriptions, so those fields are empty here; the business endpoint fills them from the detail page when the source has them. Only page 1 is available; a higher page returns 422 and is never relabelled as page 1. Costs 1 credit. Failed requests are free.

- **Documentation:** [https://scrappa.co/docs/eleven80-api/eleven80_search](https://scrappa.co/docs/eleven80-api/eleven80_search)
- **API group:** 11880 API
- **Endpoint:** `GET https://scrappa.co/api/11880/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 |
| --- | --- | --- | --- |
| `what` | string | Yes | What to look for, 2 to 100 characters. Example: Rechtsanwalt. |
| `where` | string | Yes | City or postal code, 2 to 100 characters. Example: Berlin or 10115. |
| `page` | integer | No | Only page 1 is served. A value above 1 returns 422 and is not billed. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/11880/search?what=Rechtsanwalt&where=Berlin"
```

## Example response

```json
{
    "success": true,
    "data": {
        "query": "Rechtsanwalt",
        "location": "Berlin",
        "page": 1,
        "per_page": 50,
        "total": 213,
        "has_more": false,
        "results": [
            {
                "id": "branchenbuch/berlin/081315878B102403749/rechtsanwaltskanzlei-kranich-kollegen",
                "name": "Rechtsanwaltskanzlei KRANICH & KOLLEGEN",
                "categories": [],
                "rating": 4.7,
                "review_count": 8,
                "address": {
                    "street": "Friedrichstra\u00dfe 10",
                    "postal_code": "10117",
                    "city": "Berlin",
                    "formatted": "Friedrichstra\u00dfe 10, 10117 Berlin"
                },
                "phone": "+493012345678",
                "website": null,
                "coordinates": {
                    "lat": 52.5163,
                    "lon": 13.3878
                }
            }
        ]
    },
    "meta": {
        "endpoint_family": "business_search",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation or Pagination Error | A parameter is invalid, or page is above 1 because 11880 serves page 1 only. This response is not billable. |
| 502 | Upstream Unavailable | 11880 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)
