Skip to content
Scrappa Get API key
Eventim API 1 credit / request

Eventim Event Search API Documentation

GET https://scrappa.co/api/eventim/events/search

Eventim Event Search API Documentation 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.

Eventim Event Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/eventim/events/search
Auth header
x-api-key
Cost
1 credit / request
Response preview
200 OK
{
    "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"
                },
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

9 optional filters available.

query string Optional

Keyword such as an artist, show or team.

Example value coffee shops
city string Optional

City name as Eventim knows it, e.g. Berlin.

Example value example
category string Optional

One live category facet value: Konzerte, Kultur, Freizeit, Humor, Musical & Show, Sport, Ticket-Gutschein or VIP & Extras.

Example value example
tags string Optional

Repeatable public tag: TICKETDIRECT or MOBILE_TICKET.

Example value example
in_stock boolean Optional

Set true to return only events with a current price.

Example value true
time_from string Optional

Earliest local start time, HH:MM. Needs time_to.

Example value example
time_to string Optional

Latest local start time, HH:MM. Needs time_from. An end before the start means an overnight window.

Example value example
sort string Optional

One of DateAsc, DateDesc, NameAsc, NameDesc, Rating or Recommendation.

Example value relevance
top integer Optional

Results per request, 1 to 50. Defaults to 20. Page one is fixed; narrow with filters instead of paging.

Example value 10

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A query parameter is missing, invalid, not supported or cannot be combined. This response is not billable.

{
    "message": "The request validation failed"
}
503

Upstream Unavailable

Eventim did not answer. This response is not billable.

{
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "The Eventim API is temporarily unavailable. Please retry."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.