Ticketmaster APIticketmaster.com ↗
Search Ticketmaster events by city, keyword, and date. Retrieve ticket price ranges, venue details, sale dates, and seatmap URLs for any event.
What is the Ticketmaster API?
The Ticketmaster API covers two endpoints that let you search and inspect live events across the Ticketmaster catalog. search_events returns up to 200 events per page with price ranges, venue coordinates, classifications, and ticket URLs, while get_event_tickets delivers per-event detail including sale windows, performer data, seatmap URLs, and geo-tagged venue records.
curl -X GET 'https://api.parse.bot/scraper/fb5822b3-5b06-425c-b65b-e97cd48127ba/search_events?city=New+York&page=0&size=5&keyword=concert&state_code=NY&sort=date%2Casc&country_code=US' \ -H 'X-API-Key: $PARSE_API_KEY'
Search events by city and state with optional keyword filtering. Returns paginated results sorted by date or relevance. Each result includes event name, dates, venue, price ranges (when available), classifications, and ticket URLs. Pages are zero-indexed with up to 200 results per page.
| Param | Type | Description |
|---|---|---|
| city | string | City name to filter events (e.g. 'New York', 'Los Angeles'). |
| page | string | Zero-indexed page number for pagination. |
| size | string | Number of results per page (1-200). |
| sort | string | Sort order for results (e.g. 'date,asc', 'date,desc', 'relevance,desc'). |
| keyword | string | Search keyword to filter events (e.g. 'concert', 'basketball'). Omitting returns all events in the location. |
| state_code | string | Two-letter US state code (e.g. 'NY', 'CA'). |
| country_code | string | Two-letter country code (e.g. 'US', 'CA'). |
{
"type": "object",
"fields": {
"page": "current zero-indexed page number",
"size": "number of results per page",
"events": "array of event objects with id, name, url, dates, venues, price_ranges, classifications, attractions, sales, and images",
"total_pages": "total number of pages available",
"total_elements": "total number of matching events"
},
"sample": {
"data": {
"page": 1,
"size": 3,
"events": [
{
"id": "k7vGF_GEbFtCZ",
"url": "https://www.ticketmaster.com/fast-lane-access-hypocrisy-not-a-new-york-new-york-08-12-2026/event/000064C9D8229380",
"name": "Fast Lane Access - Hypocrisy - Not a Concert Ticket",
"type": "special entry",
"dates": {
"end": null,
"start": {
"dateTime": "2026-08-12T23:00:00Z",
"localDate": "2026-08-12",
"localTime": "19:00:00"
},
"status": {
"code": "cancelled"
},
"timezone": "America/New_York"
},
"sales": {
"public": {
"endDateTime": "2026-08-13T01:00:00Z",
"startDateTime": "2026-06-12T16:00:00Z"
}
},
"images": [
{
"url": "https://s1.ticketm.net/dam/a/dc9/e5792e93-5656-47f0-9960-487ce37f5dc9_SOURCE",
"ratio": "16_9",
"width": 2426,
"height": 1365
}
],
"venues": [
{
"id": "KovZpZAEAdaA",
"city": {
"name": "New York"
},
"name": "Gramercy Theatre",
"state": {
"name": "New York",
"stateCode": "NY"
},
"address": {
"line1": "127 East 23rd Street"
},
"country": {
"countryCode": "US"
},
"postalCode": "10010"
}
],
"attractions": [
{
"id": "K8vZ917pnO0",
"name": "Live Nation Fast Lane"
}
],
"price_ranges": null,
"classifications": [
{
"genre": {
"name": "Undefined"
},
"segment": {
"name": "Miscellaneous"
},
"subGenre": {
"name": "Undefined"
}
}
]
}
],
"total_pages": 133,
"total_elements": 399
},
"status": "success"
}
}About the Ticketmaster API
Searching Events
The search_events endpoint accepts city, state_code, and country_code to scope results geographically, plus an optional keyword to match against event names and classifications (e.g. 'concert', 'basketball'). Results are zero-indexed via the page and size parameters — size goes up to 200 — and can be sorted with the sort parameter using values like 'date,asc' or 'relevance,desc'. Each event object in the events array includes price_ranges (min/max when the data is available), classifications (genre, segment, sub-genre), dates with start/end timestamps, venues with address and geo coordinates, attractions (performers), and a direct url to purchase tickets.
Event Detail
Once you have an id from search_events, pass it to get_event_tickets to get the full record for that event. The response adds fields not available in search results: a seatmap URL, the sales object with public sale start and end datetimes, tm_id (Ticketmaster's internal identifier), and a richer images array with width, height, and ratio for each asset. The dates object here includes a status code and timezone field, which is useful when displaying event times to users across regions.
Coverage and Filtering
Geographic filtering relies on city and state_code (two-letter US codes like 'NY') or country_code for international queries. Keyword filtering is optional — omitting it returns all events in the specified location. price_ranges are present when Ticketmaster exposes them for the event; they may be null for events where pricing has not yet been published or is handled by the venue.
The Ticketmaster API is a managed, monitored endpoint for ticketmaster.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ticketmaster.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ticketmaster.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a local events calendar filtered by city and date using
city,state_code, andsort=date,asc - Display ticket price ranges for concerts or sports games in a travel or itinerary app
- Monitor when public ticket sales open for specific events using the
salesobject fromget_event_tickets - Aggregate event images by ratio and resolution for a media-rich event discovery feed
- Map live events near a given location using
venuesgeo coordinates from search results - Track performer and attraction data across multiple event pages using the
attractionsfield - Alert users when a keyword-matched event (e.g. a specific band name) appears in their city
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Ticketmaster have an official developer API?+
What does `get_event_tickets` return beyond what `search_events` includes?+
get_event_tickets adds a seatmap URL, the sales object with precise public sale start and end datetimes, a tm_id field (Ticketmaster's internal identifier), a type field distinguishing event kinds like 'special entry', and a more complete images array with per-image width, height, and ratio values. The dates object also includes a status code and timezone field not surfaced in search results.Are price ranges always present in results?+
price_ranges field is included when Ticketmaster has published pricing for the event. For events where ticket prices have not yet been set or are managed externally by the venue, the field may be null. Treat price_ranges as optional in your data model.Does the API support filtering by specific venue, artist, or event category?+
city, state_code, country_code, and free-text keyword. There is no dedicated parameter for venue ID, artist ID, or classification segment. You can fork this API on Parse and revise it to add an endpoint that filters by attraction or venue identifier.