Ticketmaster Event Search API Documentation Search Ticketmaster events on ticketmaster.com, .co.uk, .de, .ie and .com.au. Search by keyword (q), or by place: city or lat and lng, which maps to the nearest supported city. Filter by start and end date and by category (with a place). Each event has the id (accepted by the Event endpoint; source_id holds the original Ticketmaster number when it differs; domain is the site that sells the event, or null for an event of a partner site: pass it to the Event, Venue and Artist endpoints), name, page URL, status (on_sale, sold_out, limited, cancelled, postponed, rescheduled, tba), start in ISO 8601 with the local offset and in UTC, time zone, sale and presale dates, venue with coordinates, performers, seat map picture and image. Venue and artist ids are null for events sold by another seller. On ticketmaster.de the venue id is null, because the site shares one id between many venues. Search results carry no prices: open the Event endpoint for price levels. Only events that start on a requested day (in the venue time zone) are returned, so a page can hold fewer events than page_size. The total is capped at 10000 by Ticketmaster. A page behind the last one is an empty 200 response. Costs 1 credit per request. A response without data and every error cost nothing.
Run this endpoint
Endpoint
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.
13 optional filters available.
string
Optional
One of com, co.uk, de, ie, com.au. Defaults to com. An event url sets it by itself.
example.com
string
Optional
Keyword such as an artist, team or show. Not together with city, lat/lng or category.
coffee shops
string
Optional
City name as Ticketmaster knows it, e.g. Chicago, London, Frankfurt am Main. Not together with lat/lng or q.
example
string
Optional
Optional state or province code of the city, e.g. IL. Needs city.
example
string
Optional
Optional country code of the city, e.g. US. Needs city. Defaults to the country of the site.
example
number
Optional
Latitude. Needs lng. The nearest supported city within 120 km is searched; otherwise the answer is 422.
10
number
Optional
Longitude. Needs lat.
10
string
Optional
First day, YYYY-MM-DD. Defaults to today.
2026-06-15
string
Optional
Last day, YYYY-MM-DD. Defaults to no end.
2026-06-15
string
Optional
One of music, sports, arts_theatre, family, miscellaneous. Needs city or lat/lng.
example
string
Optional
One of relevance, date. Defaults to relevance.
relevance
integer
Optional
Page number, from 1. Defaults to 1.
1
integer
Optional
Results per page, 2 to 50. Defaults to 20.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"results": [
{
"id": "040064E7C1E4B0F4",
"end": null,
"url": "https://www.ticketmaster.com/suicide-silence-reminders-of-hell-tour-chicago-illinois-12-01-2026/event/040064E7C1E4B0F4",
"name": "Suicide Silence: REMINDERS OF HELL TOUR",
"image": "https://s1.ticketm.net/dam/a/60f/7dca79da-4a1a-4849-9603-26e6f5bc160f_RETINA_PORTRAIT_16_9.jpg",
"start": "2026-12-01T18:00:00-06:00",
"venue": {
"id": "32905",
"url": "https://www.ticketmaster.com/house-of-blues-chicago-tickets-chicago/venue/32905",
"city": "Chicago",
"name": "House of Blues Chicago",
"image": "https://s1.ticketm.net/dbimages/21879v.jpg",
"state": "IL",
"address": "329 N Dearborn St",
"country": "US",
"latitude": 41.88811537,
"longitude": -87.62931962,
"postal_code": "60654"
},
"domain": "com",
"prices": null,
"status": "on_sale",
"artists": [
{
"id": "1009888",
"url": "https://www.ticketmaster.com/suicide-silence-tickets/artist/1009888",
"name": "Suicide Silence",
"image": "https://s1.ticketm.net/dam/a/60f/7dca79da-4a1a-4849-9603-26e6f5bc160f_RETINA_PORTRAIT_16_9.jpg"
}
],
"category": "music",
"presales": [
{
"end": "2026-07-24T03:00:00Z",
"name": "Citi\u00ae Cardmember Presale",
"start": "2026-07-21T16:00:00Z"
}
],
"timezone": "America/Chicago",
"source_id": null,
"start_utc": "2026-12-02T00:00:00Z",
"is_virtual": false,
"start_date": "2026-12-01",
"start_time": "18:00",
"seatmap_url": "https://mapsapi.tmol.io/maps/geometry/3/event/040064E7C1E4B0F4/staticImage?type=png&systemId=HOST",
"on_sale_date": "2026-07-24T15:00:00Z",
"is_partner_event": false
}
],
"pagination": {
"page": 1,
"has_more": true,
"page_size": 20,
"total_results": 574
}
},
"meta": {
"billable": true,
"endpoint_family": "events_search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing, invalid, not supported by this endpoint or cannot be combined with another one. This response is not billable.
{
"errors": {
"q": [
"Send q, city, or lat and lng."
]
},
"message": "The request validation failed"
}Not Found
Ticketmaster has no such record, or it has ended. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "events_search"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested Ticketmaster resource was not found."
},
"success": false
}Upstream Unavailable
Ticketmaster did not answer after several attempts. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "events_search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Ticketmaster 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.