Eventbrite City Browse API Documentation Return the curated shelves of an Eventbrite city page. Each shelf has a key, template, name, see-more filter recipe and a list of event cards in the same shape as the search results. Pass the keys of shelves you already have in exclude_buckets to load the next shelves.
Run this endpoint
Eventbrite City Browse API Documentation
1 credit/request
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
place_id
string
Required
Eventbrite place id of the city. Example: 101748799.
Example value
1234567890
online_only
boolean
Optional
Set to true to return only online events.
Example value
true
exclude_buckets
array
Optional
Keys of shelves already loaded. 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
{
"data": {
"place": {
"id": "101748799",
"name": "Berlin",
"subtitle": "Berlin",
"parent_id": "102063945",
"place_type": "locality"
},
"buckets": [
{
"key": "nightlife_events",
"name": "After 8pm",
"type": "event",
"events": [
{
"id": "1983603194552",
"url": "https://www.eventbrite.com/e/halloween-party-the-abandoned-factory-pt-2-tickets-1983603194552",
"name": "Halloween Party - The Abandoned Factory Pt. 2",
"tags": [
{
"tag": "EventbriteSubCategory/16004",
"name": "Halloween/Haunt",
"prefix": "EventbriteSubCategory"
},
{
"tag": "EventbriteCategory/116",
"name": "Seasonal & Holiday",
"prefix": "EventbriteCategory"
}
],
"image": {
"url": "https://img.evbuc.com/https%3A%2F%2Fcdn.evbuc.com%2Fimages%2F1150230023%2F282457477133%2F1%2Foriginal.20251010-181405?crop=focalpoint&fit=crop&w=400&auto=for...",
"aspect_ratio": "1.5"
},
"price": {
"maximum": {
"value": 2374,
"display": "23.74 EUR",
"currency": "EUR",
"major_value": "23.74"
},
"minimum": {
"value": 2374,
"display": "23.74 EUR",
"currency": "EUR",
"major_value": "23.74"
}
},
"sales": {
"currency": "EUR",
"sales_status": "on_sale",
"end_sales_date": {
"utc": "2026-11-01T21:00:00Z",
"local": "2026-11-01T22:00:00",
"timezone": "Europe/Berlin"
},
"start_sales_date": {
"utc": "2026-02-13T23:00:00Z",
"local": "2026-02-14T00:00:00",
"timezone": "Europe/Berlin"
}
},
"venue": {
"id": "296524316",
"name": "Greifswalder Str. 25",
"address": {
"city": "Berlin",
"region": "BE",
"country": "DE",
"latitude": "52.5316349",
"address_1": "Greifswalder Stra\u00dfe 25",
"longitude": "13.4281977",
"postal_code": "10405",
"localized_area_display": "Berlin",
"localized_address_display": "Greifswalder Stra\u00dfe 25, 10405 Berlin",
"localized_multi_line_address_display": [
"Greifswalder Stra\u00dfe 25",
"10405 Berlin"
]
}
},
"series": {
"num_children": 1
},
"summary": "Halloween - The Abandoned Factory Pt. 2",
"urgency": {
"messages": [
"fewTickets"
]
},
"end_date": "2026-11-01",
"end_time": "06:00",
"language": "de-de",
"timezone": "Europe/Berlin",
"organizer": {
"id": "14992406323",
"url": "https://www.eventbrite.com/o/halloween-berlin-14992406323",
"name": "Halloween Berlin",
"facebook": "events/171835669920286",
"profile_type": "organizer",
"num_followers": 323
},
"published": "2026-02-20T10:02:49Z",
"start_date": "2026-10-31",
"start_time": "22:00",
"tickets_by": "Eventbrite",
"tickets_url": "https://www.eventbrite.com/checkout-external?eid=1983603194552",
"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": "1997553769096",
"url": "https://www.eventbrite.de/e/date-night-fisch-sucht-fahrrad-berlin-halloween-special-2026-tickets-1997553769096",
"name": "Date Night & Fisch sucht Fahrrad Berlin | Halloween-Special 2026",
"tags": [
{
"tag": "EventbriteSubCategory/3013",
"name": "Pop",
"prefix": "EventbriteSubCategory"
},
{
"tag": "EventbriteCategory/103",
"name": "Music",
"prefix": "EventbriteCategory"
}
],
"image": {
"url": "https://img.evbuc.com/https%3A%2F%2Fcdn.evbuc.com%2Fimages%2F1190802565%2F170079183335%2F1%2Foriginal.20260811-144247?crop=focalpoint&fit=crop&w=512&auto=for...",
"aspect_ratio": "2"
},
"price": {
"maximum": {
"value": 1900,
"display": "19.00 EUR",
"currency": "EUR",
"major_value": "19.00"
},
"minimum": {
"value": 1900,
"display": "19.00 EUR",
"currency": "EUR",
"major_value": "19.00"
}
},
"sales": {
"currency": "EUR",
"sales_status": "on_sale",
"end_sales_date": {
"utc": "2026-10-31T19:00:00Z",
"local": "2026-10-31T20:00:00",
"timezone": "Europe/Berlin"
},
"start_sales_date": {
"utc": "2026-08-10T22:00:00Z",
"local": "2026-08-11T00:00:00",
"timezone": "Europe/Berlin"
}
},
"venue": {
"id": "298940994",
"name": "SilverWings Club",
"address": {
"city": "Berlin",
"region": "Berlin",
"country": "DE",
"latitude": "52.48368439999999",
"address_1": "Columbiadamm 10",
"longitude": "13.390213",
"postal_code": "10965",
"localized_area_display": "Berlin",
"localized_address_display": "Columbiadamm 10, 10965 Berlin",
"localized_multi_line_address_display": [
"Columbiadamm 10",
"10965 Berlin"
]
}
},
"series": {
"num_children": 1
},
"summary": "Zwei Berliner Single-Partyreihen. Zwei Floors. Eine gro\u00dfe Halloween-Nacht.",
"urgency": {
"messages": [
"goingFast"
]
},
"end_date": "2026-11-01",
"end_time": "03:00",
"language": "de-de",
"timezone": "Europe/Berlin",
"organizer": {
"id": "10141247264",
"url": "https://www.eventbrite.de/o/date-night-fisch-sucht-fahrrad-10141247264",
"name": "Date Night - Fisch sucht Fahrrad",
"summary": "Du hast genug von langweiligen Dating-Apps? Dann ist DATE NIGHT genau das Richtige f\u00fcr dich! Auf der beliebtesten Offline Dating-Party Deutschlands treffen s...",
"facebook": "fsf.datenight",
"website_url": "https://datenight.de/",
"profile_type": "organizer",
"num_followers": 1720
},
"published": "2026-08-11T09:41:17Z",
"start_date": "2026-10-31",
"start_time": "21:00",
"tickets_by": "Eventbrite",
"tickets_url": "https://www.eventbrite.com/checkout-external?eid=1997553769096",
"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
}
],
"key_min": "cne",
"see_more": {
"url": "https://www.eventbrite.com/b/germany--berlin/nightlife/"
},
"template": "card_small_4"
},
{
"key": "popular_events",
"name": "Popular in Berlin",
"type": "event",
"events": [
{
"id": "2003261625448",
"url": "https://www.eventbrite.de/e/belmilan-wineparty-tickets-2003261625448",
"name": "BELMILAN WINEPARTY",
"tags": [
{
"tag": "EventbriteSubCategory/10002",
"name": "Wine",
"prefix": "EventbriteSubCategory"
},
{
"tag": "EventbriteCategory/110",
"name": "Food & Drink",
"prefix": "EventbriteCategory"
}
],
"image": {
"url": "https://img.evbuc.com/https%3A%2F%2Fcdn.evbuc.com%2Fimages%2F1195553207%2F2803642960181%2F1%2Foriginal.20261011-172030?crop=focalpoint&fit=crop&w=400&auto=fo...",
"aspect_ratio": "1.775"
},
"price": {
"maximum": {
"value": 0,
"display": "0.00 USD",
"currency": "USD",
"major_value": "0.00"
},
"minimum": {
"value": 0,
"display": "0.00 USD",
"currency": "USD",
"major_value": "0.00"
}
},
"sales": {
"currency": "USD",
"sales_status": "on_sale",
"end_sales_date": {
"utc": "2026-10-22T16:00:00Z",
"local": "2026-10-22T18:00:00",
"timezone": "Europe/Berlin"
},
"start_sales_date": {
"utc": "2026-10-11T09:00:00Z",
"local": "2026-10-11T11:00:00",
"timezone": "Europe/Berlin"
}
},
"venue": {
"id": "299796217",
"name": "Ganghoferstra\u00dfe 10",
"address": {
"city": "Berlin",
"region": "BE",
"country": "DE",
"latitude": "52.4793523",
"address_1": "Ganghoferstra\u00dfe 10",
"longitude": "13.4391228",
"postal_code": "12043",
"localized_area_display": "Berlin",
"localized_address_display": "Ganghoferstra\u00dfe 10, 12043 Berlin",
"localized_multi_line_address_display": [
"Ganghoferstra\u00dfe 10",
"12043 Berlin"
]
}
},
"series": {
"num_children": 1
},
"summary": "Don't miss our next winepartyyyyy",
"urgency": {
"messages": [
"salesEndSoon"
]
},
"end_date": "2026-10-22",
"end_time": "23:00",
"language": "en-us",
"timezone": "Europe/Berlin",
"organizer": {
"id": "112585916051",
"url": "https://www.eventbrite.de/o/belmilan-112585916051",
"name": "BELMILAN",
"summary": "Belmilan was never just about wine. It was always about creating something bigger. It is about bringing people together through good wine. A community. A lif...",
"website_url": "https://www.instagram.com/belmilan_vino/",
"profile_type": "organizer",
"num_followers": 73
},
"published": "2026-10-11T17:21:29Z",
"start_date": "2026-10-22",
"start_time": "18:00",
"tickets_by": "Eventbrite",
"tickets_url": "https://www.eventbrite.com/checkout-external?eid=2003261625448",
"availability": {
"is_free": true,
"is_sold_out": false,
"has_bogo_tickets": false,
"has_available_tickets": true
},
"is_cancelled": false,
"is_online_event": false,
"is_protected_event": false
},
{
"id": "2003053285297",
"url": "https://www.eventbrite.de/e/ausstellungseroffnung-miela-reina-tickets-2003053285297",
"name": "Ausstellungser\u00f6ffnung: Miela Reina",
"tags": [
{
"tag": "EventbriteSubCategory/5999",
"name": "Other",
"prefix": "EventbriteSubCategory"
},
{
"tag": "EventbriteCategory/105",
"name": "Performing & Visual Arts",
"prefix": "EventbriteCategory"
}
],
"image": {
"url": "https://img.evbuc.com/https%3A%2F%2Fcdn.evbuc.com%2Fimages%2F1195263393%2F204560290254%2F1%2Foriginal.20261007-102536?crop=focalpoint&fit=crop&w=512&auto=for...",
"aspect_ratio": "2"
},
"price": {
"maximum": {
"value": 0,
"display": "0.00 EUR",
"currency": "EUR",
"major_value": "0.00"
},
"minimum": {
"value": 0,
"display": "0.00 EUR",
"currency": "EUR",
"major_value": "0.00"
}
},
"sales": {
"currency": "EUR",
"sales_status": "on_sale",
"end_sales_date": {
"utc": "2026-10-22T13:00:00Z",
"local": "2026-10-22T15:00:00",
"timezone": "Europe/Berlin"
},
"start_sales_date": {
"utc": "2026-10-12T08:00:00Z",
"local": "2026-10-12T10:00:00",
"timezone": "Europe/Berlin"
}
},
"venue": {
"id": "299741595",
"name": "Italienisches Kulturinstitut",
"address": {
"city": "Berlin",
"region": "BE",
"country": "DE",
"latitude": "52.5091705",
"address_1": "Hildebrandstr. 2",
"longitude": "13.3597523",
"postal_code": "10785",
"localized_area_display": "Berlin",
"localized_address_display": "Hildebrandstr. 2, 10785 Berlin",
"localized_multi_line_address_display": [
"Hildebrandstr. 2",
"10785 Berlin"
]
}
},
"series": {
"num_children": 1
},
"summary": "Die Arte Viva einer K\u00fcnstlerin aus Triest. 1935-1972",
"urgency": {
"messages": [
"salesEndSoon",
"fewTickets"
],
"categories": [
"popular"
]
},
"end_date": "2026-10-22",
"end_time": "21:30",
"language": "de-de",
"timezone": "Europe/Berlin",
"organizer": {
"id": "13071905266",
"url": "https://www.eventbrite.de/o/italienisches-kulturinstitut-berlin-13071905266",
"name": "Italienisches Kulturinstitut Berlin",
"summary": "Das Italienische Kulturinstitut Berlin, offizielles Organ des italienischen Staates und Kulturabteilung der Italienischen Botschaft, hat die Aufgabe, die ita...",
"twitter": "iicberlino",
"facebook": "iicberlino",
"profile_type": "organizer",
"num_followers": 1149
},
"published": "2026-10-07T10:57:10Z",
"start_date": "2026-10-22",
"start_time": "19:00",
"tickets_by": "Eventbrite",
"tickets_url": "https://www.eventbrite.com/checkout-external?eid=2003053285297",
"availability": {
"is_free": true,
"is_sold_out": false,
"has_bogo_tickets": false,
"has_available_tickets": true
},
"is_cancelled": false,
"is_online_event": false,
"is_protected_event": false
}
],
"key_min": "cpe2",
"see_more": {
"url": "https://www.eventbrite.com/d/germany--berlin/all-events/",
"params": {
"dates": [
"future"
],
"places": [
"101748799"
]
}
},
"template": "card_small_8",
"display_type": "small_card_list"
}
],
"has_more_buckets": false
},
"meta": {
"billable": true,
"endpoint_family": "city_browse"
},
"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": "city_browse"
},
"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": "city_browse"
},
"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.