# Ticketmaster Event Search API Documentation

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.

- **Documentation:** [https://scrappa.co/docs/ticketmaster-api/ticketmaster_events_search](https://scrappa.co/docs/ticketmaster-api/ticketmaster_events_search) - **API group:** Ticketmaster API - **Endpoint:** `GET https://scrappa.co/api/ticketmaster/events/search` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string | No | One of com, co.uk, de, ie, com.au. Defaults to com. An event url sets it by itself. | | `q` | string | No | Keyword such as an artist, team or show. Not together with city, lat/lng or category. | | `city` | string | No | City name as Ticketmaster knows it, e.g. Chicago, London, Frankfurt am Main. Not together with lat/lng or q. | | `state_code` | string | No | Optional state or province code of the city, e.g. IL. Needs city. | | `country_code` | string | No | Optional country code of the city, e.g. US. Needs city. Defaults to the country of the site. | | `lat` | number | No | Latitude. Needs lng. The nearest supported city within 120 km is searched; otherwise the answer is 422. | | `lng` | number | No | Longitude. Needs lat. | | `start_date` | string | No | First day, YYYY-MM-DD. Defaults to today. | | `end_date` | string | No | Last day, YYYY-MM-DD. Defaults to no end. | | `category` | string | No | One of music, sports, arts_theatre, family, miscellaneous. Needs city or lat/lng. | | `sort` | string | No | One of relevance, date. Defaults to relevance. | | `page` | integer | No | Page number, from 1. Defaults to 1. | | `page_size` | integer | No | Results per page, 2 to 50. Defaults to 20. | ## Example response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | 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. | | 404 | Not Found | Ticketmaster has no such record, or it has ended. This response is not billable. | | 503 | Upstream Unavailable | Ticketmaster did not answer after several attempts. This response is not billable. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)