# Billiger.de Shop API Documentation

Fetch merchant identity, company and support information, returns, payment and shipping methods, certificates, and rating aggregates by canonical Billiger shop ID.

- **Documentation:** [https://staging.scrappa.co/docs/billiger-api/billiger_shop](https://staging.scrappa.co/docs/billiger-api/billiger_shop)
- **API group:** Billiger.de API
- **Endpoint:** `GET https://scrappa.co/api/billiger/shop`

## 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 |
| --- | --- | --- | --- |
| `shop_id` | integer | Yes | Canonical Billiger shop identifier from an offer. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/billiger/shop?shop_id=10992"
```

## Example response

```json
{
    "success": true,
    "data": {
        "shop_id": 10992,
        "name": "Example Shop"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | Returned when required identifiers, query text, pagination, or numeric offer condition parameters are invalid. |
| 502 | Invalid Upstream Response | Returned as a non-billable failure when Billiger returns an unsuccessful, malformed, oversized, or incomplete response. No partial results are billed. Check the HTTP status before parsing the body because an intermediary may replace an error response. |
| 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://staging.scrappa.co/docs)
- [Full LLM-readable API reference](https://staging.scrappa.co/llms-full.txt)
- [OpenAPI specification](https://staging.scrappa.co/docs/api.json)
- [Pricing](https://staging.scrappa.co/pricing)