# Traum-Ferienwohnungen Search API Documentation

<p><strong>Traum-Ferienwohnungen Search API Documentation</strong> Search holiday rentals by region, dates and guests. Public logged-out data only. One credit per successful request.</p>

- **Documentation:** [https://scrappa.co/docs/traum-ferienwohnungen-api/traum_ferienwohnungen_search](https://scrappa.co/docs/traum-ferienwohnungen-api/traum_ferienwohnungen_search)
- **API group:** Traum-Ferienwohnungen API
- **Endpoint:** `GET https://scrappa.co/api/traum-ferienwohnungen/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 |
| --- | --- | --- | --- |
| `region_path` | string | No | Results path, default /europa/deutschland/ergebnisse/ |
| `arrival` | string | No | Check-in date, ISO 8601 |
| `departure` | string | No | Check-out date, ISO 8601 |
| `adults` | integer | No | Guest count, 1 to 16, default 2 |
| `page` | integer | No | Page number, default 1 |

## Example response

```json
{
    "data": {
        "page": 1,
        "cards": [
            {
                "id": "297743",
                "price": {
                    "amount": 89.5,
                    "currency": "EUR"
                },
                "images": [
                    "https://example.invalid/full.jpg"
                ],
                "rating": {
                    "count": 42,
                    "average": 8.6
                }
            }
        ],
        "total": 120
    },
    "meta": {
        "billable": true
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Errors | Failed upstream requests return HTTP 503 with success false and billable false. |

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