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

Eventbrite Event Search API Documentation

GET https://scrappa.co/api/eventbrite/search

Eventbrite Event Search API Documentation Search public Eventbrite events by free text, place id, coordinates with radius or bounding box, date preset or date range, category, subcategory, format, free or paid and price range. Each result has the id, name, summary, dates and time zone, event and ticket URLs, online and cancelled flags, tags, locations, venue with coordinates, organizer with followers and links, minimum and maximum ticket price (value in minor units, major_value, display and currency), availability, sales window, urgency signals and image. Set aggs to get facet counts. Up to 50 results per page. A search with no hits is still a successful response. The sort option selects a smaller set of events, it does not reorder the full result list.

Eventbrite Event Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/eventbrite/search
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
{
    "data": {
        "facets": {
            "tags": {
                "buckets": [
                    {
                        "key": "EventbriteFormat/9",
                        "inflated": {
                            "tag": "EventbriteFormat/9",
                            "prefix": "EventbriteFormat",
                            "display_name": "Class, Training, or Workshop"
                        },
                        "doc_count": 989,
                        "display_name": "Class, Training, or Workshop"
...

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.

22 optional filters available.

q string Optional

Free search text, e.g. jazz. Empty means all events.

Example value coffee shops
place_id string Optional

Eventbrite place id from the Places or Place endpoint. Example: 101748799 (Berlin).

Example value 1234567890
latitude number Optional

Latitude of the search center. Needs longitude.

Example value 10
longitude number Optional

Longitude of the search center. Needs latitude.

Example value 10
radius string Optional

Radius around the center, e.g. 10km or 5mi. A bare number means kilometres. Defaults to 10km.

Example value example
bbox string Optional

Four comma-separated numbers: west,south,east,north. Example: 13.0,52.4,13.6,52.6.

Example value example
dates string Optional

One of current_future, today, tomorrow, this_weekend, this_week, past. Defaults to current_future. Not together with date_from or date_to.

Example value example
date_from string Optional

First day, format YYYY-MM-DD. Not together with dates.

Example value 2026-06-15
date_to string Optional

Last day, format YYYY-MM-DD.

Example value 2026-06-15
category string Optional

Category id from the Categories endpoint, e.g. 103 (Music).

Example value example
subcategory string Optional

Subcategory id from the Subcategories endpoint.

Example value example
format string Optional

Format id from the Formats endpoint.

Example value example
price string Optional

free or paid. Not together with price_min or price_max.

Example value example
price_min integer Optional

Lowest ticket price in minor units (500 = 5.00). Needs currency.

Example value 10
price_max integer Optional

Highest ticket price in minor units. Needs currency.

Example value 10
currency string Optional

Three-letter currency code for price_min and price_max, e.g. EUR.

Example value USD
online_only boolean Optional

Set to true to return only online events.

Example value true
organizer_id string Optional

Only events of this organizer.

Example value 1234567890
sort string Optional

One of date, price, distance. It selects a smaller set of events and does not reorder the full list.

Example value relevance
page integer Optional

Page number, starting at 1.

Example value 1
page_size integer Optional

Results per page, 1 to 50. Defaults to 20.

Example value 10
aggs array Optional

Facet counts to return: any of tags, places_borough, places_neighborhood, organizer. Repeat the parameter for several.

Example value ["example"]

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": {
        "facets": {
            "tags": {
                "buckets": [
                    {
                        "key": "EventbriteFormat/9",
                        "inflated": {
                            "tag": "EventbriteFormat/9",
                            "prefix": "EventbriteFormat",
                            "display_name": "Class, Training, or Workshop"
                        },
                        "doc_count": 989,
                        "display_name": "Class, Training, or Workshop"
                    },
                    {
                        "key": "EventbriteFormat/6",
                        "inflated": {
                            "tag": "EventbriteFormat/6",
                            "prefix": "EventbriteFormat",
                            "display_name": "Concert or Performance"
                        },
                        "doc_count": 813,
                        "display_name": "Concert or Performance"
                    }
                ]
            }
        },
        "results": [
            {
                "id": "2003469318664",
                "url": "https://www.eventbrite.de/e/jazz-n-beats-tickets-2003469318664",
                "name": "Jazz\u00b4N\u00b4Beats",
                "tags": [
                    {
                        "tag": "EventbriteCategory/103",
                        "name": "Music",
                        "prefix": "EventbriteCategory"
                    },
                    {
                        "tag": "EventbriteFormat/11",
                        "name": "Party or Social Gathering",
                        "prefix": "EventbriteFormat"
                    }
                ],
                "image": {
                    "url": "https://img.evbuc.com/https%3A%2F%2Fcdn.evbuc.com%2Fimages%2F1195946708%2F156947755306%2F1%2Foriginal.20261016-143626?crop=focalpoint&fit=crop&auto=format%2C...",
                    "aspect_ratio": "1.335"
                },
                "price": {
                    "maximum": {
                        "value": 1183,
                        "display": "11.83 EUR",
                        "currency": "EUR",
                        "major_value": "11.83"
                    },
                    "minimum": {
                        "value": 1183,
                        "display": "11.83 EUR",
                        "currency": "EUR",
                        "major_value": "11.83"
                    }
                },
                "sales": {
                    "currency": "EUR",
                    "sales_status": "on_sale",
                    "end_sales_date": {
                        "utc": "2026-10-26T17:00:00Z",
                        "local": "2026-10-26T18:00:00",
                        "timezone": "Europe/Berlin"
                    },
                    "start_sales_date": {
                        "utc": "2026-10-16T14:40:00Z",
                        "local": "2026-10-16T16:40:00",
                        "timezone": "Europe/Berlin"
                    }
                },
                "venue": {
                    "id": "299863483",
                    "name": "Ballhaus Berlin GmbH",
                    "address": {
                        "city": "Berlin",
                        "region": "BE",
                        "country": "DE",
                        "latitude": "52.5322213",
                        "address_1": "Chausseestra\u00dfe 102",
                        "longitude": "13.3804414",
                        "postal_code": "10115",
                        "localized_area_display": "Berlin",
                        "localized_address_display": "Chausseestra\u00dfe 102, 10115 Berlin",
                        "localized_multi_line_address_display": [
                            "Chausseestra\u00dfe 102",
                            "10115 Berlin"
                        ]
                    }
                },
                "series": {
                    "num_children": 1
                },
                "summary": "Music from all Jazz influenced genres and decades. From classic grooves to electronic beats. Performed by selected DJs and live musicians!",
                "urgency": {
                    "categories": [
                        "new"
                    ]
                },
                "end_date": "2026-10-26",
                "end_time": "23:30",
                "language": "en-us",
                "timezone": "Europe/Berlin",
                "locations": [
                    {
                        "id": "102191581",
                        "name": "Europe",
                        "type": "continent"
                    },
                    {
                        "id": "85633111",
                        "name": "Germany",
                        "type": "country"
                    }
                ],
                "organizer": {
                    "id": "8582527069",
                    "url": "https://www.eventbrite.de/o/ballhaus-berlin-8582527069",
                    "name": "Ballhaus Berlin",
                    "summary": "\u00c4ltestes Berliner Ballhaus, er\u00f6ffnet 1905 mit einer Original Telefonanlage aus den 30er Jahren, garantiert abh\u00f6rsicher ... Eventlocation und Live-Programme",
                    "twitter": "@BallhausBerlin",
                    "facebook": "ballhaus.berlin",
                    "website_url": "https://www.ballhaus-berlin.de/",
                    "profile_type": "organizer",
                    "num_followers": 280
                },
                "published": "2026-10-15T17:24:58Z",
                "start_date": "2026-10-26",
                "start_time": "19:00",
                "tickets_by": "Eventbrite",
                "tickets_url": "https://www.eventbrite.com/checkout-external?eid=2003469318664",
                "availability": {
                    "is_free": false,
                    "is_sold_out": false,
                    "has_bogo_tickets": false,
                    "has_available_tickets": true
                },
                "is_cancelled": false,
                "is_online_event": false,
                "is_protected_event": false
            },
            {
                "id": "2001042410717",
                "url": "https://www.eventbrite.de/e/jazzexzess-w-luise-volkmanns-punk-jazz-projekt-vehiclepassenger-tickets-2001042410717",
                "name": "jazzexzess w/ Luise Volkmann\u2019s Punk-Jazz-Projekt + Vehicle/Passenger",
                "tags": [
                    {
                        "tag": "EventbriteCategory/103",
                        "name": "Music",
                        "prefix": "EventbriteCategory"
                    },
                    {
                        "tag": "EventbriteFormat/6",
                        "name": "Concert or Performance",
                        "prefix": "EventbriteFormat"
                    }
                ],
                "image": {
                    "url": "https://img.evbuc.com/https%3A%2F%2Fcdn.evbuc.com%2Fimages%2F1193534618%2F2754692005421%2F1%2Foriginal.20260915-091630?crop=focalpoint&fit=crop&auto=format%2...",
                    "aspect_ratio": "2"
                },
                "price": {
                    "maximum": {
                        "value": 1717,
                        "display": "17.17 EUR",
                        "currency": "EUR",
                        "major_value": "17.17"
                    },
                    "minimum": {
                        "value": 1183,
                        "display": "11.83 EUR",
                        "currency": "EUR",
                        "major_value": "11.83"
                    }
                },
                "sales": {
                    "currency": "EUR",
                    "sales_status": "on_sale",
                    "end_sales_date": {
                        "utc": "2026-11-24T23:00:00Z",
                        "local": "2026-11-25T00:00:00",
                        "timezone": "Europe/Berlin"
                    },
                    "start_sales_date": {
                        "utc": "2026-09-15T23:00:00Z",
                        "local": "2026-09-16T01:00:00",
                        "timezone": "Europe/Berlin"
                    }
                },
                "venue": {
                    "id": "299431608",
                    "name": "House of Music",
                    "address": {
                        "city": "Berlin",
                        "region": "BE",
                        "country": "DE",
                        "latitude": "52.50670330000001",
                        "address_1": "Revaler Stra\u00dfe 99",
                        "longitude": "13.4535486",
                        "postal_code": "10245",
                        "localized_area_display": "Berlin",
                        "localized_address_display": "Revaler Stra\u00dfe 99, 10245 Berlin",
                        "localized_multi_line_address_display": [
                            "Revaler Stra\u00dfe 99",
                            "10245 Berlin"
                        ]
                    }
                },
                "series": {
                    "num_children": 1
                },
                "summary": "Luise Volkmann und vehicle/passenger verbinden Punk, Free Jazz, Noise, Hip-Hop und Poesie zu einem Abend politischer Dringlichkeit.",
                "end_date": "2026-10-24",
                "end_time": "22:00",
                "language": "de-de",
                "timezone": "Europe/Berlin",
                "locations": [
                    {
                        "id": "102191581",
                        "name": "Europe",
                        "type": "continent"
                    },
                    {
                        "id": "85633111",
                        "name": "Germany",
                        "type": "country"
                    }
                ],
                "organizer": {
                    "id": "14358707265",
                    "url": "https://www.eventbrite.de/o/jazzexzess-14358707265",
                    "name": "jazzexzess",
                    "summary": "pr\u00e4sentiert die junge, kreative Jazzszene in unterschiedlichen Konzertreihen",
                    "facebook": "jazzexzess",
                    "website_url": "https://jazzexzess.de/",
                    "profile_type": "organizer",
                    "num_followers": 313
                },
                "published": "2026-09-15T09:27:55Z",
                "start_date": "2026-10-24",
                "start_time": "20:00",
                "tickets_by": "Eventbrite",
                "tickets_url": "https://www.eventbrite.com/checkout-external?eid=2001042410717",
                "availability": {
                    "is_free": false,
                    "is_sold_out": false,
                    "has_bogo_tickets": false,
                    "has_available_tickets": true
                },
                "is_cancelled": false,
                "is_online_event": false,
                "is_protected_event": false
            }
        ],
        "pagination": {
            "page": 1,
            "has_more": true,
            "page_size": 3,
            "page_count": 332,
            "total_results": 3285
        },
        "suggested_categories": [
            {
                "id": "EventbriteSubCategory/3027",
                "name": "jazz",
                "type": "subcategory"
            },
            {
                "id": "EventbriteSubCategory/3002",
                "name": "blues & jazz",
                "type": "subcategory"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

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

422

Validation Error

A query parameter is missing, invalid or not supported by this endpoint. This response is not billable.

{
    "errors": {
        "q": [
            "The q field is required."
        ]
    },
    "message": "The request validation failed"
}
502

Unexpected Upstream Format

Eventbrite answered in a format this API does not understand. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "UNEXPECTED_RESPONSE",
        "message": "Eventbrite answered in an unexpected format. Please retry later."
    },
    "success": false
}
503

Upstream Unavailable

Eventbrite did not answer after several attempts. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "The Eventbrite 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.