# Eventim Event Search API Documentation

<p><strong>Eventim Event Search API Documentation</strong> Search Eventim events by keyword, city, a live category facet value, public tags, a local time window and stock. Each event has its product id, product group id, name, local start and end date, venue, city, postal code, coordinates, price from with currency, availability, image, rating, category, promoter and tags. Set in_stock to true to keep only events with a current price. An end time before the start time means an overnight window. The upstream ignores page, so page one is fixed; narrow the request with filters instead. Each successful response costs 1 credit. Failed requests, validation errors and empty pages cost nothing.</p>

- **Documentation:** [https://scrappa.co/docs/eventim-api/eventim_search](https://scrappa.co/docs/eventim-api/eventim_search)
- **API group:** Eventim API
- **Endpoint:** `GET https://scrappa.co/api/eventim/events/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 |
| --- | --- | --- | --- |
| `query` | string | No | Keyword such as an artist, show or team. |
| `city` | string | No | City name as Eventim knows it, e.g. Berlin. |
| `category` | string | No | One live category facet value: Konzerte, Kultur, Freizeit, Humor, Musical & Show, Sport, Ticket-Gutschein or VIP & Extras. |
| `tags` | string | No | Repeatable public tag: TICKETDIRECT or MOBILE_TICKET. |
| `in_stock` | boolean | No | Set true to return only events with a current price. |
| `time_from` | string | No | Earliest local start time, HH:MM. Needs time_to. |
| `time_to` | string | No | Latest local start time, HH:MM. Needs time_from. An end before the start means an overnight window. |
| `sort` | string | No | One of DateAsc, DateDesc, NameAsc, NameDesc, Rating or Recommendation. |
| `top` | integer | No | Results per request, 1 to 50. Defaults to 20. Page one is fixed; narrow with filters instead of paging. |

## Example response

```json
{
    "data": {
        "results": [
            {
                "id": "21994953",
                "name": "Example concert",
                "start": "2026-08-15T13:00:00+02:00",
                "venue": {
                    "city": "Berlin",
                    "name": "Example venue",
                    "latitude": 52.52,
                    "longitude": 13.405,
                    "postal_code": "10115"
                },
                "currency": "EUR",
                "price_from": 39.9,
                "start_date": "2026-08-15",
                "product_group_id": "4139442"
            }
        ],
        "pagination": {
            "page": 1,
            "has_more": true,
            "page_size": 1,
            "total_results": 15860
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "events_search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing, invalid, not supported or cannot be combined. This response is not billable. |
| 503 | Upstream Unavailable | Eventim did not answer. This response is not billable. |

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