# Ticketmaster > Search live events with Ticketmaster's Discovery API: concerts, sport, theatre, comedy and family shows across more than 20 countries, from Ticketmaster, Universe, FrontGate and Ticketmaster Resale. Find what is on near a place or in a city, follow an artist's tour dates or a venue's diary, be told when tickets go on sale, and read an event in full: venue, line-up, prices, onsale windows and the link to buy. App · Events · 19 actions. Web page: https://docs.lodol.com/docs/integrations/ticketmaster ## Actions ### Count events Count how many events match a search, and return the first one. It costs a single request whether the answer is three events or thirty thousand, so it is the cheap check to branch a workflow on: send the digest only when there is something on, or alert someone when an artist adds dates. **Inputs** - Search for (`keyword`, text): Optional. Words to search on: an artist, a team, a show or part of an event's name. Leave it empty to browse by the filters below alone. - City (`city`, list): Optional. Only include events in these cities, by name. Add more than one to cover a region. - State or province code (`state_code`, text): Optional. The two-letter state or province code, for the countries that have them (NY, CA, ON). Pair it with the country below. - Country (`country_code`, text): Optional. Only include events in this country. One of: `AD` (Andorra), `AI` (Anguilla), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), `BH` (Bahrain), `BB` (Barbados), `BE` (Belgium), and 73 more. - Postcode or ZIP (`postal_code`, text): Optional. Only include events in this postcode or ZIP code. It is an exact match, not a radius; use Find events near a location for that. - Market (`market_id`, text): Optional. A Ticketmaster market: a metropolitan area, wider than a city and narrower than a country. One of: `50` (Alaska [US]), `110` (B.C. Interior [Canada]), `502` (Barcelona (Spain) [Europe]), `123` (Beaumont [US]), `1` (Birmingham & More [US]), `108` (Calgary & Southern Alberta [Canada]), `54` (Central Illinois [US]), `2` (Charlotte [US]), `3` (Chicagoland & Northern IL [US]), `4` (Cincinnati & Dayton [US]), and 82 more. - Designated market area (`dma_id`, text): Optional. A DMA, the broadcast regions US and Canadian media buyers use. Finer than a market, and the way to say 'the Bay Area' rather than 'San Francisco'. One of: `212` (Abilene - Sweetwater), `213` (Albany - Schenectady - Troy), `214` (Albany, GA), `215` (Albuquerque - Santa Fe), `216` (Alexandria, LA), `701` (All of Australia), `500` (All of Canada), `608` (All of Ireland), `801` (All of Mexico), `750` (All of New Zealand), and 260 more. - Venue id (`venue_id`, text): Optional. Only include events at this venue. Venue ids come from Search venues. - Attraction id (`attraction_id`, text): Optional. Only include events for this artist, team or show. Attraction ids come from Search attractions. - Category (`segment_id`, text): Optional. The top level of Ticketmaster's own classification: Music, Sports, Arts & Theatre, Film and so on. The list comes from your connection. - Genre (`genre_id`, text): Optional. A genre inside the category above (Rock inside Music, Basketball inside Sports). Pick a category first to load its genres. - Classification names (`classification_name`, list): Optional. Filter by the name of any classification level instead of its id: 'Music', 'Rock', 'Comedy'. Put a minus in front to exclude one ('-Parking'). - Starting on or after (`start_date_time`, date and time): Optional. Only include events that start at or after this moment. Times are converted to UTC for you. - Starting on or before (`end_date_time`, date and time): Optional. Only include events that start at or before this moment. Times are converted to UTC for you. **Outputs** - `city` (text): The city filter that was applied - `country_code` (text): The country filter that was applied - `end_date_time` (text): The latest start time asked for, in UTC - `first_event` (object): The soonest matching event - `has_events` (true/false): True when at least one event matches - `keyword` (text): The keyword the search ran with - `start_date_time` (text): The earliest start time asked for, in UTC - `total_results` (number): How many events match **Example output** ```json { "city": null, "country_code": "US", "end_date_time": "2026-12-31T23:59:59Z", "first_event": { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "G5diZfkn0B-bh", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-09-27T23:30:00Z", "start_local_date": "2026-09-27", "start_local_time": "19:30:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-new-york-new-york/event/3B00506AA4EA161B", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" }, "has_events": true, "keyword": "Radiohead", "start_date_time": "2026-09-01T00:00:00Z", "total_results": 37 } ``` ### Find events going on sale Find the events whose tickets go on sale next, soonest onsale first, and only the ones inside the window you choose. This is the alert to put on a schedule: run it every morning for your city or your favourite act, and hear about an onsale while there are still tickets. **Inputs** - Going on sale within (`window`, text): How far ahead to look for onsales, counted from the moment the step runs. Only events whose public onsale starts inside this window are returned. One of: `24h` (Next 24 hours), `48h` (Next 48 hours), `7d` (Next 7 days), `14d` (Next 14 days), `30d` (Next 30 days), `90d` (Next 90 days), `180d` (Next 6 months), `365d` (Next 12 months). Default: `7d`. - Search for (`keyword`, text): Optional. Words to search on: an artist, a team, a show or part of an event's name. Leave it empty to browse by the filters below alone. - City (`city`, list): Optional. Only include events in these cities, by name. Add more than one to cover a region. - Country (`country_code`, text): Optional. Only include events in this country. One of: `AD` (Andorra), `AI` (Anguilla), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), `BH` (Bahrain), `BB` (Barbados), `BE` (Belgium), and 73 more. - Category (`segment_id`, text): Optional. The top level of Ticketmaster's own classification: Music, Sports, Arts & Theatre, Film and so on. The list comes from your connection. - Attraction id (`attraction_id`, text): Optional. Only include events for this artist, team or show. Attraction ids come from Search attractions. - How many results (`page_size`, number): How many results to return per page, from 1 to 200. From 1 to 200. Default: `20`. **Outputs** - `city` (text): The city filter that was applied - `country_code` (text): The country filter that was applied - `event_count` (number): How many of those there are - `events` (list): The events whose onsale starts inside the window - `events_returned` (number): How many events the request returned before the window was applied - `has_more` (true/false): True when another page can still be fetched - `keyword` (text): The keyword the search ran with - `next_onsale` (object): The very next onsale, even when it falls outside the window - `onsale_from` (text): The start of the onsale window, in UTC - `onsale_until` (text): The end of the onsale window, in UTC - `page` (number): The page that was returned, from 1 - `page_size` (number): How many were asked for per page - `total_pages` (number): How many pages that comes to - `total_results` (number): How many results match in total, across all pages - `window` (text): The window that was asked for - `window_label` (text): That window in words **Example output** ```json { "city": null, "country_code": "US", "event_count": 1, "events": [ { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "G5diZfkn0B-bh", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-09-27T23:30:00Z", "start_local_date": "2026-09-27", "start_local_time": "19:30:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-new-york-new-york/event/3B00506AA4EA161B", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" } ], "events_returned": 20, "has_more": true, "keyword": null, "next_onsale": { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "G5diZfkn0B-bh", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-09-27T23:30:00Z", "start_local_date": "2026-09-27", "start_local_time": "19:30:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-new-york-new-york/event/3B00506AA4EA161B", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" }, "onsale_from": "2026-08-23T10:00:00Z", "onsale_until": "2026-08-30T10:00:00Z", "page": 1, "page_size": 20, "total_pages": 211, "total_results": 4213, "window": "7d", "window_label": "Next 7 days" } ``` ### Find events near a location Find events within a distance of a point on the map, nearest first, with how far away each one is. Give a latitude and a longitude in plain degrees; the geohash the API wants is worked out for you. Narrow it by keyword, category or dates. This is the action behind 'what is on near me this weekend'. **Inputs** - Latitude (`latitude`, number, required): The latitude of the point to search around, in degrees (51.5074 for London). It is turned into the geohash the API wants for you. From -90 to 90. - Longitude (`longitude`, number, required): The longitude of the point to search around, in degrees (-0.1278 for London). From -180 to 180. - Within (`radius`, number): How far from the point to look, in the unit below, up to 19999. Defaults to 25. From 0 to 19999. Default: `25`. - Measured in (`radius_unit`, text): The unit the distance above is in. One of: `miles`, `km` (Kilometres). Default: `miles`. - Search for (`keyword`, text): Optional. Words to search on: an artist, a team, a show or part of an event's name. Leave it empty to browse by the filters below alone. - Category (`segment_id`, text): Optional. The top level of Ticketmaster's own classification: Music, Sports, Arts & Theatre, Film and so on. The list comes from your connection. - Genre (`genre_id`, text): Optional. A genre inside the category above (Rock inside Music, Basketball inside Sports). Pick a category first to load its genres. - Classification names (`classification_name`, list): Optional. Filter by the name of any classification level instead of its id: 'Music', 'Rock', 'Comedy'. Put a minus in front to exclude one ('-Parking'). - Starting on or after (`start_date_time`, date and time): Optional. Only include events that start at or after this moment. Times are converted to UTC for you. - Starting on or before (`end_date_time`, date and time): Optional. Only include events that start at or before this moment. Times are converted to UTC for you. - Order results by (`sort`, text): How to order the events. Nearest first by default. One of: `relevance,desc` (Best match first), `relevance,asc` (Least relevant first), `date,asc` (Soonest first), `date,desc` (Furthest ahead first), `name,asc` (Event name (A-Z)), `name,desc` (Event name (Z-A)), `distance,asc` (Nearest first), `name,date,asc` (Event name (A-Z), then soonest), `name,date,desc` (Event name (Z-A), then furthest ahead), `date,name,asc` (Soonest, then event name (A-Z)), and 7 more. Default: `distance,asc`. - How many results (`page_size`, number): How many results to return per page, from 1 to 200. From 1 to 200. Default: `20`. - Page (`page`, number): Which page of results to return. Page 1 is the first. Ticketmaster pages through at most 1000 results, so with 20 per page the last page is 50. At least 1. Default: `1`. **Outputs** - `end_date_time` (text): The latest start time asked for, in UTC - `event_count` (number): How many events this page actually returned - `events` (list): The events on this page - `geo_point` (text): The geohash those coordinates became - `has_more` (true/false): True when another page can still be fetched - `keyword` (text): The keyword the search ran with - `latitude` (number): The latitude that was searched around - `longitude` (number): The longitude that was searched around - `page` (number): The page that was returned, from 1 - `page_size` (number): How many were asked for per page - `radius` (number): How far around the point was searched - `radius_unit` (text): The unit that distance is in - `sort` (text): The ordering that was applied - `start_date_time` (text): The earliest start time asked for, in UTC - `total_pages` (number): How many pages that comes to - `total_results` (number): How many results match in total, across all pages **Example output** ```json { "end_date_time": null, "event_count": 2, "events": [ { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "G5diZfkn0B-bh", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-09-27T23:30:00Z", "start_local_date": "2026-09-27", "start_local_time": "19:30:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-new-york-new-york/event/3B00506AA4EA161B", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" }, { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "vvG1zZfkn0B-cd", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-10-01T00:00:00Z", "start_local_date": "2026-09-30", "start_local_time": "20:00:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-boston/event/01005A9F3D6F2E1C", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" } ], "geo_point": "dr5ru62bn", "has_more": true, "keyword": null, "latitude": 40.7497, "longitude": -73.9916, "page": 1, "page_size": 20, "radius": 25, "radius_unit": "miles", "sort": "distance,asc", "start_date_time": null, "total_pages": 2, "total_results": 37 } ``` ### Get attraction details Read one artist, team or show in full: how Ticketmaster classifies them, their artwork, their own site and social profiles, the names they are also listed under, and how many dates they have coming up. **Inputs** - Attraction id (`attraction_id`, text, required): The attraction to read. Ids come from Search attractions; they look like K8vZ91713wV. - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. **Outputs** - `aliases` (list): Other names the act is listed under - `description` (text): The act's own description - `external_links` (object): The act's own site and social profiles - `family` (true/false): True when the classification is family-friendly - `genre_id` (text): Id of the genre - `genre_name` (text): The genre's name, e.g. 'Rock' - `id` (text): Ticketmaster's id for the attraction - `image_url` (text): The largest image, ready to attach - `images` (list): Every image the entity has, largest first - `locale` (text): Language the copy came back in - `name` (text): The act's name - `segment_id` (text): Id of the top-level category (Music, Sports …) - `segment_name` (text): That category's name - `subgenre_id` (text): Id of the sub-genre - `subgenre_name` (text): The sub-genre's name, e.g. 'Alternative Rock' - `subtype_name` (text): A finer kind, e.g. 'Band' - `test` (true/false): True for a Ticketmaster test record - `type_name` (text): The kind of act, e.g. 'Group' or 'Individual' - `upcoming_event_count` (number): How many dates the act has coming up - `url` (text): The act's page on Ticketmaster **Example output** ```json { "aliases": [ "Radio Head" ], "description": null, "external_links": { "facebook": "https://www.facebook.com/radiohead", "homepage": "https://www.radiohead.com", "instagram": "https://www.instagram.com/radiohead", "itunes": "https://music.apple.com/artist/radiohead/657515", "lastfm": "https://www.last.fm/music/Radiohead", "musicbrainz": "a74b1b7f-71a5-4011-9441-d0b5e4122711", "spotify": "https://open.spotify.com/artist/4Z8W4fKeB5YxbusRsdQVPb", "twitter": "https://twitter.com/radiohead", "wiki": "https://en.wikipedia.org/wiki/Radiohead", "youtube": "https://www.youtube.com/user/radiohead" }, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "K8vZ91713wV", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "locale": "en-us", "name": "Radiohead", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "type_name": "Group", "upcoming_event_count": 12, "url": "https://www.ticketmaster.com/radiohead-tickets/artist/763468" } ``` ### Get category details Read one top-level category (Music, Sports, Arts & Theatre) and get every genre inside it, each with its own sub-genres. One read gives the whole branch of the tree, which is how a workflow turns 'Rock' into the genre id a search filter takes. **Inputs** - Category (`segment_id`, text, required): The category to read. The list comes from your connection. - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. **Outputs** - `genre_count` (number): How many genres it has - `genres` (list): The genres inside it, each with its sub-genres - `id` (text): The category's id - `name` (text): The category's name **Example output** ```json { "genre_count": 2, "genres": [ { "id": "KnvZfZ7vAeA", "name": "Rock", "subgenres": [ { "id": "KZazBEonSMnZfZ7v6dt", "name": "Alternative Rock" }, { "id": "KZazBEonSMnZfZ7v6F1", "name": "Pop" } ] }, { "id": "KnvZfZ7vAvv", "name": "Pop", "subgenres": [ { "id": "KZazBEonSMnZfZ7v6F1", "name": "Pop" } ] } ], "id": "KZFzniwnSyZfZ7v7nJ", "name": "Music" } ``` ### Get classification details Read one classification by id, whichever level it belongs to. The same endpoint answers for a category, a genre or a sub-genre, so the result says which level came back and lists what sits below it. **Inputs** - Classification id (`classification_id`, text, required): The category, genre or sub-genre to read. Ids come from Search classifications. - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. **Outputs** - `child_count` (number): How many of those there are - `children` (list): What sits below it - `children_are` (text): What the level below is called - `family` (true/false): True when this is a family classification - `id` (text): The level's id - `level` (text): Which level came back: 'segment' or 'type' - `name` (text): The level's name **Example output** ```json { "child_count": 2, "children": [ { "id": "KnvZfZ7vAeA", "name": "Rock", "subgenres": [ { "id": "KZazBEonSMnZfZ7v6dt", "name": "Alternative Rock" }, { "id": "KZazBEonSMnZfZ7v6F1", "name": "Pop" } ] }, { "id": "KnvZfZ7vAvv", "name": "Pop", "subgenres": [ { "id": "KZazBEonSMnZfZ7v6F1", "name": "Pop" } ] } ], "children_are": "genres", "family": false, "id": "KZFzniwnSyZfZ7v7nJ", "level": "segment", "name": "Music" } ``` ### Get event details Read one event in full: the venue and its address, who is playing, the local start time and the timezone, every published price range, the public onsale and presale windows, the seat map, the ticket limit, the access notes and the link to buy. **Inputs** - Event id (`event_id`, text, required): The event to read. Ids come from any search step; they look like G5diZfkn0B-bh. - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. **Outputs** - `accessibility_info` (text): Accessible seating and access notes - `attraction_ids` (list): Ids of the acts playing, for looking up their other dates - `attraction_names` (list): Names of the acts playing - `date_tba` (true/false): True when the date is to be announced - `date_tbd` (true/false): True when the date is to be decided - `distance` (number): How far the event is from the point searched around - `distance_unit` (text): The unit that distance is in - `end_datetime` (text): The exact moment it ends, in UTC, when published - `family` (true/false): True when the classification is family-friendly - `genre_id` (text): Id of the genre - `genre_name` (text): The genre's name, e.g. 'Rock' - `id` (text): Ticketmaster's id for the event - `image_url` (text): The largest image, ready to attach - `images` (list): Every image the entity has, largest first - `info` (text): Ticketmaster's notes about the event - `is_on_sale` (true/false): True when tickets are on sale right now - `locale` (text): Language the copy came back in - `name` (text): The event's name - `onsale_end` (text): When the public onsale ends, in UTC - `onsale_start` (text): When the public onsale starts, in UTC - `onsale_tbd` (true/false): True when the onsale date has not been set - `please_note` (text): Conditions of entry and delivery notes - `presales` (list): Presales, each with its own window and link - `price_currency` (text): The currency prices are in - `price_max` (number): The dearest published price - `price_min` (number): The cheapest published ticket price, across all types - `price_ranges` (list): Every published price range, by ticket type - `promoter_id` (text): Id of the promoter, for finding their other events - `promoter_name` (text): Who is promoting the event - `seatmap_url` (text): Link to the venue's seat map - `segment_id` (text): Id of the top-level category (Music, Sports …) - `segment_name` (text): That category's name - `spans_multiple_days` (true/false): True for a festival or run that covers several days - `start_datetime` (text): The exact moment it starts, in UTC (ISO 8601) - `start_local_date` (text): The date it starts, local to the venue (YYYY-MM-DD) - `start_local_time` (text): The time it starts, local to the venue (HH:MM:SS) - `status` (text): Status code: onsale, offsale, cancelled, postponed, rescheduled - `status_label` (text): That status in words - `subgenre_id` (text): Id of the sub-genre - `subgenre_name` (text): The sub-genre's name, e.g. 'Alternative Rock' - `subtype_name` (text): A finer kind, e.g. 'Band' - `test` (true/false): True for a Ticketmaster test record - `ticket_limit` (text): The per-buyer ticket limit - `time_tba` (true/false): True when the date is set but the time is not - `timezone` (text): The venue's timezone - `type_name` (text): The kind of act, e.g. 'Group' or 'Individual' - `url` (text): Link to buy tickets on Ticketmaster - `venue_address` (text): The venue's street address - `venue_city` (text): The venue's city - `venue_country_code` (text): The venue's country code - `venue_id` (text): Id of the venue it is at - `venue_latitude` (number): The venue's latitude - `venue_longitude` (number): The venue's longitude - `venue_name` (text): The venue's name - `venue_postal_code` (text): The venue's postcode or ZIP - `venue_state_code` (text): The venue's state code **Example output** ```json { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "G5diZfkn0B-bh", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-09-27T23:30:00Z", "start_local_date": "2026-09-27", "start_local_time": "19:30:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-new-york-new-york/event/3B00506AA4EA161B", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" } ``` ### Get event images Get every picture Ticketmaster holds for an event. The same artwork comes back at a dozen sizes and aspect ratios in no order at all, so this sorts them largest first and counts each ratio; the first one is the one to put in an email or a post. **Inputs** - Event id (`event_id`, text, required): The event whose artwork to fetch. Ids come from any search step. - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. **Outputs** - `event_id` (text): The event the images belong to - `event_name` (text): That event's name - `event_url` (text): Link to the event on Ticketmaster - `image_count` (number): How many images came back - `images` (list): Every image the entity has, largest first - `largest_image_url` (text): The largest image, ready to attach - `ratios` (list): How many images there are of each shape **Example output** ```json { "event_id": "G5diZfkn0B-bh", "event_name": "Radiohead", "event_url": "https://www.ticketmaster.com/radiohead-new-york-new-york/event/3B00506AA4EA161B", "image_count": 2, "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "largest_image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "ratios": [ { "image_count": 1, "ratio": "16_9" }, { "image_count": 1, "ratio": "3_2" } ] } ``` ### Get events at a venue List what is on at one venue, soonest first. The venue id comes from Search venues, and the answer is the same event shape every other event action returns, so a workflow can watch a room's diary and post what has been added. **Inputs** - Venue id (`venue_id`, text, required): The venue whose events to list. Ids come from Search venues; they look like KovZpZA7AAEA. - Search for (`keyword`, text): Optional. Words to search on: an artist, a team, a show or part of an event's name. Leave it empty to browse by the filters below alone. - Starting on or after (`start_date_time`, date and time): Optional. Only include events that start at or after this moment. Times are converted to UTC for you. - Starting on or before (`end_date_time`, date and time): Optional. Only include events that start at or before this moment. Times are converted to UTC for you. - Events with no date announced (`include_tba`, text): Optional. What to do with events whose date is still to be announced. They are left out by default when you filter on a date. One of: `no` (Leave them out), `yes` (Include them), `only` (Only these). - Events with no date decided (`include_tbd`, text): Optional. The same, for events whose date is to be decided rather than announced. One of: `no` (Leave them out), `yes` (Include them), `only` (Only these). - Order results by (`sort`, text): How to order the events. Soonest first by default. One of: `relevance,desc` (Best match first), `relevance,asc` (Least relevant first), `date,asc` (Soonest first), `date,desc` (Furthest ahead first), `name,asc` (Event name (A-Z)), `name,desc` (Event name (Z-A)), `distance,asc` (Nearest first), `name,date,asc` (Event name (A-Z), then soonest), `name,date,desc` (Event name (Z-A), then furthest ahead), `date,name,asc` (Soonest, then event name (A-Z)), and 7 more. Default: `date,asc`. - How many results (`page_size`, number): How many results to return per page, from 1 to 200. From 1 to 200. Default: `20`. - Page (`page`, number): Which page of results to return. Page 1 is the first. Ticketmaster pages through at most 1000 results, so with 20 per page the last page is 50. At least 1. Default: `1`. **Outputs** - `end_date_time` (text): The latest start time asked for, in UTC - `event_count` (number): How many events this page actually returned - `events` (list): The events on this page - `has_more` (true/false): True when another page can still be fetched - `keyword` (text): The keyword the search ran with - `page` (number): The page that was returned, from 1 - `page_size` (number): How many were asked for per page - `sort` (text): The ordering that was applied - `start_date_time` (text): The earliest start time asked for, in UTC - `total_pages` (number): How many pages that comes to - `total_results` (number): How many results match in total, across all pages - `venue_id` (text): The venue that was read **Example output** ```json { "end_date_time": "2026-10-01T00:00:00Z", "event_count": 2, "events": [ { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "G5diZfkn0B-bh", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-09-27T23:30:00Z", "start_local_date": "2026-09-27", "start_local_time": "19:30:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-new-york-new-york/event/3B00506AA4EA161B", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" }, { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "vvG1zZfkn0B-cd", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-10-01T00:00:00Z", "start_local_date": "2026-09-30", "start_local_time": "20:00:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-boston/event/01005A9F3D6F2E1C", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" } ], "has_more": true, "keyword": null, "page": 1, "page_size": 20, "sort": "date,asc", "start_date_time": "2026-09-01T00:00:00Z", "total_pages": 2, "total_results": 37, "venue_id": "KovZpZA7AAEA" } ``` ### Get events for an attraction List every date an artist, team or show is playing. A tour is one attraction with many events, so this is what turns 'Radiohead' into their tour dates. Narrow it to a country or a city to answer 'are they playing near me'. **Inputs** - Attraction id (`attraction_id`, text, required): The artist, team or show whose dates to list. Ids come from Search attractions; they look like K8vZ91713wV. - Country (`country_code`, text): Optional. Only include events in this country. One of: `AD` (Andorra), `AI` (Anguilla), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), `BH` (Bahrain), `BB` (Barbados), `BE` (Belgium), and 73 more. - City (`city`, list): Optional. Only include events in these cities, by name. Add more than one to cover a region. - Starting on or after (`start_date_time`, date and time): Optional. Only include events that start at or after this moment. Times are converted to UTC for you. - Starting on or before (`end_date_time`, date and time): Optional. Only include events that start at or before this moment. Times are converted to UTC for you. - Order results by (`sort`, text): How to order the events. Soonest first by default. One of: `relevance,desc` (Best match first), `relevance,asc` (Least relevant first), `date,asc` (Soonest first), `date,desc` (Furthest ahead first), `name,asc` (Event name (A-Z)), `name,desc` (Event name (Z-A)), `distance,asc` (Nearest first), `name,date,asc` (Event name (A-Z), then soonest), `name,date,desc` (Event name (Z-A), then furthest ahead), `date,name,asc` (Soonest, then event name (A-Z)), and 7 more. Default: `date,asc`. - How many results (`page_size`, number): How many results to return per page, from 1 to 200. From 1 to 200. Default: `20`. - Page (`page`, number): Which page of results to return. Page 1 is the first. Ticketmaster pages through at most 1000 results, so with 20 per page the last page is 50. At least 1. Default: `1`. **Outputs** - `attraction_id` (text): The attraction that was read - `city` (text): The city filter that was applied - `country_code` (text): The country filter that was applied - `end_date_time` (text): The latest start time asked for, in UTC - `event_count` (number): How many events this page actually returned - `events` (list): The events on this page - `has_more` (true/false): True when another page can still be fetched - `page` (number): The page that was returned, from 1 - `page_size` (number): How many were asked for per page - `sort` (text): The ordering that was applied - `start_date_time` (text): The earliest start time asked for, in UTC - `total_pages` (number): How many pages that comes to - `total_results` (number): How many results match in total, across all pages **Example output** ```json { "attraction_id": "K8vZ91713wV", "city": null, "country_code": "US", "end_date_time": null, "event_count": 2, "events": [ { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "G5diZfkn0B-bh", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-09-27T23:30:00Z", "start_local_date": "2026-09-27", "start_local_time": "19:30:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-new-york-new-york/event/3B00506AA4EA161B", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" }, { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "vvG1zZfkn0B-cd", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-10-01T00:00:00Z", "start_local_date": "2026-09-30", "start_local_time": "20:00:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-boston/event/01005A9F3D6F2E1C", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" } ], "has_more": true, "page": 1, "page_size": 20, "sort": "date,asc", "start_date_time": null, "total_pages": 2, "total_results": 37 } ``` ### Get genre details Read one genre and the sub-genres beneath it: Rock, and the Alternative Rock, Britpop and Psychedelic inside it. Genre ids come from Get category details or Search classifications. **Inputs** - Genre id (`genre_id`, text, required): The genre to read. Ids come from Get category details or Search classifications; they look like KnvZfZ7vAeA. - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. **Outputs** - `id` (text): The genre's id - `name` (text): The genre's name - `subgenre_count` (number): How many sub-genres it has - `subgenres` (list): The sub-genres inside it **Example output** ```json { "id": "KnvZfZ7vAeA", "name": "Rock", "subgenre_count": 2, "subgenres": [ { "id": "KZazBEonSMnZfZ7v6dt", "name": "Alternative Rock" }, { "id": "KZazBEonSMnZfZ7v6F1", "name": "Pop" } ] } ``` ### Get search suggestions Ask what a few words match across events, attractions, venues and packages at once: the type-ahead behind Ticketmaster's own search box. One request turns a half-remembered name, or one pulled out of an email, into the ids the rest of the actions take. **Inputs** - Search for (`keyword`, text, required): The words to suggest against. A few characters is enough; this is a type-ahead, not a full search. - Look in (`resources`, list): Which kinds of thing to suggest. Leave it empty for all four, which is the default. One or more of: `events`, `attractions` (Attractions (artists, teams, shows)), `venues`, `products` (Products (packages and parking)). - Country (`country_code`, text): Optional. Only include events in this country. One of: `AD` (Andorra), `AI` (Anguilla), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), `BH` (Bahrain), `BB` (Barbados), `BE` (Belgium), and 73 more. - Category (`segment_id`, text): Optional. The top level of Ticketmaster's own classification: Music, Sports, Arts & Theatre, Film and so on. The list comes from your connection. - Latitude (`latitude`, number): Optional. Give a latitude and a longitude together to search around a point, nearest first. Leave both empty to search by name. From -90 to 90. - Longitude (`longitude`, number): Optional. The longitude that goes with the latitude above. From -180 to 180. - Within (`radius`, number): How far from the point to look, in the unit below, up to 19999. Defaults to 25. From 0 to 19999. Default: `25`. - Measured in (`radius_unit`, text): The unit the distance above is in. One of: `miles`, `km` (Kilometres). Default: `miles`. - Events with no date announced (`include_tba`, text): Optional. What to do with events whose date is still to be announced. They are left out by default when you filter on a date. One of: `no` (Leave them out), `yes` (Include them), `only` (Only these). - Events with no date decided (`include_tbd`, text): Optional. The same, for events whose date is to be decided rather than announced. One of: `no` (Leave them out), `yes` (Include them), `only` (Only these). - How many of each (`size`, number): How many suggestions to return per kind, from 1 to 20. From 1 to 20. Default: `5`. - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. **Outputs** - `attractions` (list): Suggested artists, teams and shows - `events` (list): Suggested events - `geo_point` (text): The geohash the coordinates became, when a point was given - `keyword` (text): The keyword the search ran with - `products` (list): Suggested packages, parking and add-ons - `resources` (text): Which kinds were asked for - `suggestion_count` (number): How many suggestions came back in total - `venues` (list): Suggested venues **Example output** ```json { "attractions": [ { "aliases": [ "Radio Head" ], "description": null, "external_links": { "facebook": "https://www.facebook.com/radiohead", "homepage": "https://www.radiohead.com", "instagram": "https://www.instagram.com/radiohead", "itunes": "https://music.apple.com/artist/radiohead/657515", "lastfm": "https://www.last.fm/music/Radiohead", "musicbrainz": "a74b1b7f-71a5-4011-9441-d0b5e4122711", "spotify": "https://open.spotify.com/artist/4Z8W4fKeB5YxbusRsdQVPb", "twitter": "https://twitter.com/radiohead", "wiki": "https://en.wikipedia.org/wiki/Radiohead", "youtube": "https://www.youtube.com/user/radiohead" }, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "K8vZ91713wV", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "locale": "en-us", "name": "Radiohead", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "type_name": "Group", "upcoming_event_count": 12, "url": "https://www.ticketmaster.com/radiohead-tickets/artist/763468" } ], "events": [ { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "G5diZfkn0B-bh", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-09-27T23:30:00Z", "start_local_date": "2026-09-27", "start_local_time": "19:30:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-new-york-new-york/event/3B00506AA4EA161B", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" } ], "geo_point": null, "keyword": "radio", "products": [ { "id": "Z7r9jZ1AdFO2t", "name": "Radiohead VIP Package", "type": "package", "url": "https://www.ticketmaster.com/radiohead-vip" } ], "resources": "events,attractions,venues", "suggestion_count": 4, "venues": [ { "accessible_seating_detail": "Accessible seating is available on every level.", "address": "7th Ave & 32nd Street", "box_office_hours": "Monday - Saturday: 12:00pm - 6:00pm", "box_office_payment": "Cash, American Express, Visa, MasterCard", "box_office_phone": "(212) 465-6741", "box_office_will_call": "Pick up at the box office with photo ID.", "child_rule": "Everyone needs a ticket, whatever their age.", "city": "New York", "country": "United States Of America", "country_code": "US", "currency": "USD", "description": null, "distance": null, "distance_unit": null, "dma_ids": [ "200", "345" ], "general_rule": "Bags larger than 16in x 16in x 8in are not permitted.", "id": "KovZpZA7AAEA", "image_url": "https://s1.ticketm.net/dam/v/msg-tablet-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/v/msg-tablet-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/v/msg-retina-portrait-3-2.jpg", "width": 640 } ], "latitude": 40.7497062, "locale": "en-us", "longitude": -73.9916006, "market_ids": [ "35", "55" ], "name": "Madison Square Garden", "parking_detail": "There is no parking available at the venue.", "postal_code": "10001", "state": "New York", "state_code": "NY", "test": false, "timezone": "America/New_York", "twitter_handle": "@TheGarden", "upcoming_event_count": 148, "url": "https://www.ticketmaster.com/venue/483329" } ] } ``` ### Get sub-genre details Read one sub-genre, the finest level the classification tree has, such as Alternative Rock inside Rock inside Music. Use it to put a name to a sub-genre id an event came back with. **Inputs** - Sub-genre id (`subgenre_id`, text, required): The sub-genre to read. Ids come from Get genre details or from an event's own classification. - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. **Outputs** - `id` (text): The sub-genre's id - `name` (text): The sub-genre's name **Example output** ```json { "id": "KZazBEonSMnZfZ7v6dt", "name": "Alternative Rock" } ``` ### Get venue details Read one venue in full: its street address and coordinates, its timezone and currency, the box office's phone number and opening hours, parking, accessible seating, and the house rules on bags and children. **Inputs** - Venue id (`venue_id`, text, required): The venue to read. Ids come from Search venues; they look like KovZpZA7AAEA. - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. **Outputs** - `accessible_seating_detail` (text): Accessible seating arrangements - `address` (text): Street address, on one line - `box_office_hours` (text): Box office opening hours - `box_office_payment` (text): Payment methods the box office takes - `box_office_phone` (text): Box office phone number - `box_office_will_call` (text): Will-call arrangements - `child_rule` (text): The venue's policy on children - `city` (text): City - `country` (text): Country - `country_code` (text): ISO country code - `currency` (text): Currency tickets are priced in - `description` (text): The venue's own description - `distance` (number): How far the venue is from the point searched around - `distance_unit` (text): The unit that distance is in - `dma_ids` (list): Ids of the DMAs the venue sits in - `general_rule` (text): House rules - `id` (text): Ticketmaster's id for the venue - `image_url` (text): The largest image, ready to attach - `images` (list): Every image the entity has, largest first - `latitude` (number): Latitude - `locale` (text): Language the copy came back in - `longitude` (number): Longitude - `market_ids` (list): Ids of the markets the venue sits in - `name` (text): The venue's name - `parking_detail` (text): Parking arrangements - `postal_code` (text): Postcode or ZIP - `state` (text): State or province - `state_code` (text): State or province code - `test` (true/false): True for a Ticketmaster test record - `timezone` (text): The venue's timezone - `twitter_handle` (text): The venue's Twitter handle - `upcoming_event_count` (number): How many events the venue has coming up - `url` (text): The venue's page on Ticketmaster **Example output** ```json { "accessible_seating_detail": "Accessible seating is available on every level.", "address": "7th Ave & 32nd Street", "box_office_hours": "Monday - Saturday: 12:00pm - 6:00pm", "box_office_payment": "Cash, American Express, Visa, MasterCard", "box_office_phone": "(212) 465-6741", "box_office_will_call": "Pick up at the box office with photo ID.", "child_rule": "Everyone needs a ticket, whatever their age.", "city": "New York", "country": "United States Of America", "country_code": "US", "currency": "USD", "description": null, "distance": null, "distance_unit": null, "dma_ids": [ "200", "345" ], "general_rule": "Bags larger than 16in x 16in x 8in are not permitted.", "id": "KovZpZA7AAEA", "image_url": "https://s1.ticketm.net/dam/v/msg-tablet-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/v/msg-tablet-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/v/msg-retina-portrait-3-2.jpg", "width": 640 } ], "latitude": 40.7497062, "locale": "en-us", "longitude": -73.9916006, "market_ids": [ "35", "55" ], "name": "Madison Square Garden", "parking_detail": "There is no parking available at the venue.", "postal_code": "10001", "state": "New York", "state_code": "NY", "test": false, "timezone": "America/New_York", "twitter_handle": "@TheGarden", "upcoming_event_count": 148, "url": "https://www.ticketmaster.com/venue/483329" } ``` ### Search attractions Find an artist, team, show or package by name. This is how a workflow turns a name someone typed into the attraction id that Get events for an attraction takes, and it comes back with the act's classification, artwork, official links and how many dates they have coming up. **Inputs** - Search for (`keyword`, text): Optional. Words to search on: an artist, a team, a show or part of an event's name. Leave it empty to browse by the filters below alone. - Category (`segment_id`, text): Optional. The top level of Ticketmaster's own classification: Music, Sports, Arts & Theatre, Film and so on. The list comes from your connection. - Genre (`genre_id`, text): Optional. A genre inside the category above (Rock inside Music, Basketball inside Sports). Pick a category first to load its genres. - Sub-genre (`subgenre_id`, text): Optional. The finest level: Alternative Rock inside Rock. Pick a genre first to load its sub-genres. - Classification names (`classification_name`, list): Optional. Filter by the name of any classification level instead of its id: 'Music', 'Rock', 'Comedy'. Put a minus in front to exclude one ('-Parking'). - Ticketing platforms (`source`, list): Optional. Which platforms to include. Leave it empty for all of them, which is the default. One or more of: `ticketmaster`, `universe`, `frontgate` (FrontGate Tickets), `tmr` (Ticketmaster Resale). - Test entries (`include_test`, text): Optional. Ticketmaster's own test records are hidden by default. Include them only if you are checking the integration itself. One of: `no` (Leave test events out), `yes` (Include test events), `only` (Only test events). - Family events (`include_family`, text): Optional. Events classified as family-friendly are included by default; this can narrow to them or drop them. One of: `yes` (Include family events), `no` (Leave family events out), `only` (Only family events). - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. - Order results by (`sort`, text): How to order the attractions. One of: `relevance,desc` (Best match first), `relevance,asc` (Least relevant first), `name,asc` (Name (A-Z)), `name,desc` (Name (Z-A)), `random`. Default: `relevance,desc`. - How many results (`page_size`, number): How many results to return per page, from 1 to 200. From 1 to 200. Default: `20`. - Page (`page`, number): Which page of results to return. Page 1 is the first. Ticketmaster pages through at most 1000 results, so with 20 per page the last page is 50. At least 1. Default: `1`. **Outputs** - `attraction_count` (number): How many this page returned - `attractions` (list): The attractions on this page - `has_more` (true/false): True when another page can still be fetched - `keyword` (text): The keyword the search ran with - `page` (number): The page that was returned, from 1 - `page_size` (number): How many were asked for per page - `sort` (text): The ordering that was applied - `total_pages` (number): How many pages that comes to - `total_results` (number): How many results match in total, across all pages **Example output** ```json { "attraction_count": 1, "attractions": [ { "aliases": [ "Radio Head" ], "description": null, "external_links": { "facebook": "https://www.facebook.com/radiohead", "homepage": "https://www.radiohead.com", "instagram": "https://www.instagram.com/radiohead", "itunes": "https://music.apple.com/artist/radiohead/657515", "lastfm": "https://www.last.fm/music/Radiohead", "musicbrainz": "a74b1b7f-71a5-4011-9441-d0b5e4122711", "spotify": "https://open.spotify.com/artist/4Z8W4fKeB5YxbusRsdQVPb", "twitter": "https://twitter.com/radiohead", "wiki": "https://en.wikipedia.org/wiki/Radiohead", "youtube": "https://www.youtube.com/user/radiohead" }, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "K8vZ91713wV", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "locale": "en-us", "name": "Radiohead", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "type_name": "Group", "upcoming_event_count": 12, "url": "https://www.ticketmaster.com/radiohead-tickets/artist/763468" } ], "has_more": false, "keyword": "Radiohead", "page": 1, "page_size": 20, "sort": "relevance,desc", "total_pages": 1, "total_results": 3 } ``` ### Search classifications Browse the tree everything on Ticketmaster is filed under: categories like Music and Sports, the genres inside them, and the sub-genres inside those. This is where the ids the search filters take come from, and searching it by name is how a workflow finds the id for a genre someone named. **Inputs** - Search for (`keyword`, text): Optional. Words to search on: an artist, a team, a show or part of an event's name. Leave it empty to browse by the filters below alone. - Ticketing platforms (`source`, list): Optional. Which platforms to include. Leave it empty for all of them, which is the default. One or more of: `ticketmaster`, `universe`, `frontgate` (FrontGate Tickets), `tmr` (Ticketmaster Resale). - Test entries (`include_test`, text): Optional. Ticketmaster's own test records are hidden by default. Include them only if you are checking the integration itself. One of: `no` (Leave test events out), `yes` (Include test events), `only` (Only test events). - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. - Order results by (`sort`, text): How to order the classifications. One of: `name,asc` (Name (A-Z)), `name,desc` (Name (Z-A)), `relevance,desc` (Best match first), `relevance,asc` (Least relevant first), `random`. Default: `name,asc`. - How many results (`page_size`, number): How many results to return per page, from 1 to 200. From 1 to 200. Default: `20`. - Page (`page`, number): Which page of results to return. Page 1 is the first. Ticketmaster pages through at most 1000 results, so with 20 per page the last page is 50. At least 1. Default: `1`. **Outputs** - `classification_count` (number): How many this page returned - `classifications` (list): The classifications on this page - `has_more` (true/false): True when another page can still be fetched - `keyword` (text): The keyword the search ran with - `page` (number): The page that was returned, from 1 - `page_size` (number): How many were asked for per page - `segments` (list): Just the top-level categories, ready to use as a filter - `sort` (text): The ordering that was applied - `total_pages` (number): How many pages that comes to - `total_results` (number): How many results match in total, across all pages **Example output** ```json { "classification_count": 1, "classifications": [ { "child_count": 2, "children": [ { "id": "KnvZfZ7vAeA", "name": "Rock", "subgenres": [ { "id": "KZazBEonSMnZfZ7v6dt", "name": "Alternative Rock" }, { "id": "KZazBEonSMnZfZ7v6F1", "name": "Pop" } ] }, { "id": "KnvZfZ7vAvv", "name": "Pop", "subgenres": [ { "id": "KZazBEonSMnZfZ7v6F1", "name": "Pop" } ] } ], "children_are": "genres", "family": false, "id": "KZFzniwnSyZfZ7v7nJ", "level": "segment", "name": "Music" } ], "has_more": false, "keyword": null, "page": 1, "page_size": 20, "segments": [ { "id": "KZFzniwnSyZfZ7v7nJ", "name": "Music" } ], "sort": "name,asc", "total_pages": 1, "total_results": 6 } ``` ### Search events Search Ticketmaster's event catalogue: concerts, sport, theatre, family shows and festivals across more than 20 countries, with the filters a search actually uses. Words, where (city, state, country, postcode, market or broadcast area), what (category, genre, sub-genre or classification name), who (attraction, venue or promoter), when, and which ticketing platform. Each event comes back flattened, with its venue, its start time, its price range and its ticket link. **Inputs** - Search for (`keyword`, text): Optional. Words to search on: an artist, a team, a show or part of an event's name. Leave it empty to browse by the filters below alone. - City (`city`, list): Optional. Only include events in these cities, by name. Add more than one to cover a region. - State or province code (`state_code`, text): Optional. The two-letter state or province code, for the countries that have them (NY, CA, ON). Pair it with the country below. - Country (`country_code`, text): Optional. Only include events in this country. One of: `AD` (Andorra), `AI` (Anguilla), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), `BH` (Bahrain), `BB` (Barbados), `BE` (Belgium), and 73 more. - Postcode or ZIP (`postal_code`, text): Optional. Only include events in this postcode or ZIP code. It is an exact match, not a radius; use Find events near a location for that. - Market (`market_id`, text): Optional. A Ticketmaster market: a metropolitan area, wider than a city and narrower than a country. One of: `50` (Alaska [US]), `110` (B.C. Interior [Canada]), `502` (Barcelona (Spain) [Europe]), `123` (Beaumont [US]), `1` (Birmingham & More [US]), `108` (Calgary & Southern Alberta [Canada]), `54` (Central Illinois [US]), `2` (Charlotte [US]), `3` (Chicagoland & Northern IL [US]), `4` (Cincinnati & Dayton [US]), and 82 more. - Designated market area (`dma_id`, text): Optional. A DMA, the broadcast regions US and Canadian media buyers use. Finer than a market, and the way to say 'the Bay Area' rather than 'San Francisco'. One of: `212` (Abilene - Sweetwater), `213` (Albany - Schenectady - Troy), `214` (Albany, GA), `215` (Albuquerque - Santa Fe), `216` (Alexandria, LA), `701` (All of Australia), `500` (All of Canada), `608` (All of Ireland), `801` (All of Mexico), `750` (All of New Zealand), and 260 more. - Venue id (`venue_id`, text): Optional. Only include events at this venue. Venue ids come from Search venues. - Attraction id (`attraction_id`, text): Optional. Only include events for this artist, team or show. Attraction ids come from Search attractions. - Promoter id (`promoter_id`, text): Optional. Only include events from this promoter. The id is on any event this promoter is behind. - Category (`segment_id`, text): Optional. The top level of Ticketmaster's own classification: Music, Sports, Arts & Theatre, Film and so on. The list comes from your connection. - Genre (`genre_id`, text): Optional. A genre inside the category above (Rock inside Music, Basketball inside Sports). Pick a category first to load its genres. - Sub-genre (`subgenre_id`, text): Optional. The finest level: Alternative Rock inside Rock. Pick a genre first to load its sub-genres. - Classification names (`classification_name`, list): Optional. Filter by the name of any classification level instead of its id: 'Music', 'Rock', 'Comedy'. Put a minus in front to exclude one ('-Parking'). - Starting on or after (`start_date_time`, date and time): Optional. Only include events that start at or after this moment. Times are converted to UTC for you. - Starting on or before (`end_date_time`, date and time): Optional. Only include events that start at or before this moment. Times are converted to UTC for you. - Ticketing platforms (`source`, list): Optional. Which platforms to include. Leave it empty for all of them, which is the default. One or more of: `ticketmaster`, `universe`, `frontgate` (FrontGate Tickets), `tmr` (Ticketmaster Resale). - Events with no date announced (`include_tba`, text): Optional. What to do with events whose date is still to be announced. They are left out by default when you filter on a date. One of: `no` (Leave them out), `yes` (Include them), `only` (Only these). - Events with no date decided (`include_tbd`, text): Optional. The same, for events whose date is to be decided rather than announced. One of: `no` (Leave them out), `yes` (Include them), `only` (Only these). - Test entries (`include_test`, text): Optional. Ticketmaster's own test records are hidden by default. Include them only if you are checking the integration itself. One of: `no` (Leave test events out), `yes` (Include test events), `only` (Only test events). - Family events (`include_family`, text): Optional. Events classified as family-friendly are included by default; this can narrow to them or drop them. One of: `yes` (Include family events), `no` (Leave family events out), `only` (Only family events). - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. - Order results by (`sort`, text): How to order the events. One of: `relevance,desc` (Best match first), `relevance,asc` (Least relevant first), `date,asc` (Soonest first), `date,desc` (Furthest ahead first), `name,asc` (Event name (A-Z)), `name,desc` (Event name (Z-A)), `distance,asc` (Nearest first), `name,date,asc` (Event name (A-Z), then soonest), `name,date,desc` (Event name (Z-A), then furthest ahead), `date,name,asc` (Soonest, then event name (A-Z)), and 7 more. Default: `relevance,desc`. - How many results (`page_size`, number): How many results to return per page, from 1 to 200. From 1 to 200. Default: `20`. - Page (`page`, number): Which page of results to return. Page 1 is the first. Ticketmaster pages through at most 1000 results, so with 20 per page the last page is 50. At least 1. Default: `1`. **Outputs** - `city` (text): The city filter that was applied - `country_code` (text): The country filter that was applied - `end_date_time` (text): The latest start time asked for, in UTC - `event_count` (number): How many events this page actually returned - `events` (list): The events on this page - `has_more` (true/false): True when another page can still be fetched - `keyword` (text): The keyword the search ran with - `page` (number): The page that was returned, from 1 - `page_size` (number): How many were asked for per page - `sort` (text): The ordering that was applied - `start_date_time` (text): The earliest start time asked for, in UTC - `total_pages` (number): How many pages that comes to - `total_results` (number): How many results match in total, across all pages **Example output** ```json { "city": "New York", "country_code": "US", "end_date_time": "2026-12-31T23:59:59Z", "event_count": 2, "events": [ { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "G5diZfkn0B-bh", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-09-27T23:30:00Z", "start_local_date": "2026-09-27", "start_local_time": "19:30:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-new-york-new-york/event/3B00506AA4EA161B", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" }, { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "vvG1zZfkn0B-cd", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-10-01T00:00:00Z", "start_local_date": "2026-09-30", "start_local_time": "20:00:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-boston/event/01005A9F3D6F2E1C", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" } ], "has_more": true, "keyword": "Radiohead", "page": 1, "page_size": 20, "sort": "date,asc", "start_date_time": "2026-09-01T00:00:00Z", "total_pages": 2, "total_results": 37 } ``` ### Search upcoming events Find events starting inside a window that moves with the clock (the next 24 hours, the next week, the next month) counted from the moment the step runs, soonest first. This is the search to put on a schedule: a fixed date range would return the same events on every run and then go empty, while this one always looks at what is coming up. **Inputs** - How far ahead (`window`, text): How far ahead to look, counted from the moment the step runs, so a workflow on a schedule keeps looking at what is coming up instead of a fixed set of dates. One of: `24h` (Next 24 hours), `48h` (Next 48 hours), `7d` (Next 7 days), `14d` (Next 14 days), `30d` (Next 30 days), `90d` (Next 90 days), `180d` (Next 6 months), `365d` (Next 12 months). Default: `7d`. - Search for (`keyword`, text): Optional. Words to search on: an artist, a team, a show or part of an event's name. Leave it empty to browse by the filters below alone. - City (`city`, list): Optional. Only include events in these cities, by name. Add more than one to cover a region. - State or province code (`state_code`, text): Optional. The two-letter state or province code, for the countries that have them (NY, CA, ON). Pair it with the country below. - Country (`country_code`, text): Optional. Only include events in this country. One of: `AD` (Andorra), `AI` (Anguilla), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), `BH` (Bahrain), `BB` (Barbados), `BE` (Belgium), and 73 more. - Category (`segment_id`, text): Optional. The top level of Ticketmaster's own classification: Music, Sports, Arts & Theatre, Film and so on. The list comes from your connection. - Genre (`genre_id`, text): Optional. A genre inside the category above (Rock inside Music, Basketball inside Sports). Pick a category first to load its genres. - Order results by (`sort`, text): How to order the events. Soonest first by default. One of: `relevance,desc` (Best match first), `relevance,asc` (Least relevant first), `date,asc` (Soonest first), `date,desc` (Furthest ahead first), `name,asc` (Event name (A-Z)), `name,desc` (Event name (Z-A)), `distance,asc` (Nearest first), `name,date,asc` (Event name (A-Z), then soonest), `name,date,desc` (Event name (Z-A), then furthest ahead), `date,name,asc` (Soonest, then event name (A-Z)), and 7 more. Default: `date,asc`. - How many results (`page_size`, number): How many results to return per page, from 1 to 200. From 1 to 200. Default: `20`. **Outputs** - `city` (text): The city filter that was applied - `country_code` (text): The country filter that was applied - `end_date_time` (text): The latest start time asked for, in UTC - `event_count` (number): How many events this page actually returned - `events` (list): The events on this page - `has_more` (true/false): True when another page can still be fetched - `keyword` (text): The keyword the search ran with - `page` (number): The page that was returned, from 1 - `page_size` (number): How many were asked for per page - `sort` (text): The ordering that was applied - `start_date_time` (text): The earliest start time asked for, in UTC - `total_pages` (number): How many pages that comes to - `total_results` (number): How many results match in total, across all pages - `window` (text): The window that was asked for - `window_label` (text): That window in words **Example output** ```json { "city": "New York", "country_code": "US", "end_date_time": "2026-08-30T10:00:00Z", "event_count": 2, "events": [ { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "G5diZfkn0B-bh", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-09-27T23:30:00Z", "start_local_date": "2026-09-27", "start_local_time": "19:30:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-new-york-new-york/event/3B00506AA4EA161B", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" }, { "accessibility_info": "Accessible seating is available for this event.", "attraction_ids": [ "K8vZ91713wV" ], "attraction_names": [ "Radiohead" ], "date_tba": false, "date_tbd": false, "distance": null, "distance_unit": null, "end_datetime": null, "family": false, "genre_id": "KnvZfZ7vAeA", "genre_name": "Rock", "id": "vvG1zZfkn0B-cd", "image_url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/a/radiohead-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/a/radiohead-portrait-3-2.jpg", "width": 640 } ], "info": "Doors open at 6:30pm.", "is_on_sale": true, "locale": "en-us", "name": "Radiohead", "onsale_end": "2026-09-27T23:30:00Z", "onsale_start": "2026-08-28T14:00:00Z", "onsale_tbd": false, "please_note": "No tickets will be delivered prior to the day of the show.", "presales": [ { "description": "Open to fans on the mailing list.", "end_datetime": "2026-08-27T22:00:00Z", "name": "Artist Presale", "start_datetime": "2026-08-26T14:00:00Z", "url": "https://www.ticketmaster.com/presale" } ], "price_currency": "USD", "price_max": 221.0, "price_min": 65.0, "price_ranges": [ { "currency": "USD", "max": 195.0, "min": 65.0, "type": "standard" }, { "currency": "USD", "max": 221.0, "min": 78.5, "type": "standard including fees" } ], "promoter_id": "494", "promoter_name": "LIVE NATION MUSIC", "seatmap_url": "https://maps.ticketmaster.com/maps/geometry/3/msg.png", "segment_id": "KZFzniwnSyZfZ7v7nJ", "segment_name": "Music", "spans_multiple_days": false, "start_datetime": "2026-10-01T00:00:00Z", "start_local_date": "2026-09-30", "start_local_time": "20:00:00", "status": "onsale", "status_label": "On sale", "subgenre_id": "KZazBEonSMnZfZ7v6dt", "subgenre_name": "Alternative Rock", "subtype_name": "Band", "test": false, "ticket_limit": "There is an eight ticket limit for this event.", "time_tba": false, "timezone": "America/New_York", "type_name": "Group", "url": "https://www.ticketmaster.com/radiohead-boston/event/01005A9F3D6F2E1C", "venue_address": "7th Ave & 32nd Street", "venue_city": "New York", "venue_country_code": "US", "venue_id": "KovZpZA7AAEA", "venue_latitude": 40.7497062, "venue_longitude": -73.9916006, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state_code": "NY" } ], "has_more": true, "keyword": null, "page": 1, "page_size": 20, "sort": "date,asc", "start_date_time": "2026-08-23T10:00:00Z", "total_pages": 2, "total_results": 37, "window": "7d", "window_label": "Next 7 days" } ``` ### Search venues Find a venue by name, by country, or around a point on the map. Give a latitude and a longitude and it becomes a nearest-first search with each venue's distance. Every venue comes back with its address and coordinates, its timezone, its box office details and its house rules. **Inputs** - Search for (`keyword`, text): Optional. Words to search on: an artist, a team, a show or part of an event's name. Leave it empty to browse by the filters below alone. - Country (`country_code`, text): Optional. Only include events in this country. One of: `AD` (Andorra), `AI` (Anguilla), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), `BH` (Bahrain), `BB` (Barbados), `BE` (Belgium), and 73 more. - State or province code (`state_code`, text): Optional. The two-letter state or province code, for the countries that have them (NY, CA, ON). Pair it with the country below. - Latitude (`latitude`, number): Optional. Give a latitude and a longitude together to search around a point, nearest first. Leave both empty to search by name. From -90 to 90. - Longitude (`longitude`, number): Optional. The longitude that goes with the latitude above. From -180 to 180. - Within (`radius`, number): How far from the point to look, in the unit below, up to 19999. Defaults to 25. From 0 to 19999. Default: `25`. - Measured in (`radius_unit`, text): The unit the distance above is in. One of: `miles`, `km` (Kilometres). Default: `miles`. - Ticketing platforms (`source`, list): Optional. Which platforms to include. Leave it empty for all of them, which is the default. One or more of: `ticketmaster`, `universe`, `frontgate` (FrontGate Tickets), `tmr` (Ticketmaster Resale). - Test entries (`include_test`, text): Optional. Ticketmaster's own test records are hidden by default. Include them only if you are checking the integration itself. One of: `no` (Leave test events out), `yes` (Include test events), `only` (Only test events). - Language (`locale`, text): Optional. The language to return names and descriptions in, as an ISO code. Use '*' for every language a listing has. Ticketmaster falls back to nothing, so a listing with no copy in that language comes back empty rather than in English. - Order results by (`sort`, text): How to order the venues. One of: `relevance,desc` (Best match first), `relevance,asc` (Least relevant first), `name,asc` (Name (A-Z)), `name,desc` (Name (Z-A)), `distance,asc` (Nearest first), `distance,desc` (Furthest away first), `random`. Default: `relevance,desc`. - How many results (`page_size`, number): How many results to return per page, from 1 to 200. From 1 to 200. Default: `20`. - Page (`page`, number): Which page of results to return. Page 1 is the first. Ticketmaster pages through at most 1000 results, so with 20 per page the last page is 50. At least 1. Default: `1`. **Outputs** - `geo_point` (text): The geohash the coordinates became, when a point was given - `has_more` (true/false): True when another page can still be fetched - `keyword` (text): The keyword the search ran with - `page` (number): The page that was returned, from 1 - `page_size` (number): How many were asked for per page - `sort` (text): The ordering that was applied - `total_pages` (number): How many pages that comes to - `total_results` (number): How many results match in total, across all pages - `venue_count` (number): How many this page returned - `venues` (list): The venues on this page **Example output** ```json { "geo_point": null, "has_more": false, "keyword": "Madison Square Garden", "page": 1, "page_size": 20, "sort": "relevance,desc", "total_pages": 1, "total_results": 2, "venue_count": 1, "venues": [ { "accessible_seating_detail": "Accessible seating is available on every level.", "address": "7th Ave & 32nd Street", "box_office_hours": "Monday - Saturday: 12:00pm - 6:00pm", "box_office_payment": "Cash, American Express, Visa, MasterCard", "box_office_phone": "(212) 465-6741", "box_office_will_call": "Pick up at the box office with photo ID.", "child_rule": "Everyone needs a ticket, whatever their age.", "city": "New York", "country": "United States Of America", "country_code": "US", "currency": "USD", "description": null, "distance": null, "distance_unit": null, "dma_ids": [ "200", "345" ], "general_rule": "Bags larger than 16in x 16in x 8in are not permitted.", "id": "KovZpZA7AAEA", "image_url": "https://s1.ticketm.net/dam/v/msg-tablet-landscape-16-9.jpg", "images": [ { "attribution": null, "fallback": false, "height": 1152, "ratio": "16_9", "url": "https://s1.ticketm.net/dam/v/msg-tablet-landscape-16-9.jpg", "width": 2048 }, { "attribution": null, "fallback": false, "height": 427, "ratio": "3_2", "url": "https://s1.ticketm.net/dam/v/msg-retina-portrait-3-2.jpg", "width": 640 } ], "latitude": 40.7497062, "locale": "en-us", "longitude": -73.9916006, "market_ids": [ "35", "55" ], "name": "Madison Square Garden", "parking_detail": "There is no parking available at the venue.", "postal_code": "10001", "state": "New York", "state_code": "NY", "test": false, "timezone": "America/New_York", "twitter_handle": "@TheGarden", "upcoming_event_count": 148, "url": "https://www.ticketmaster.com/venue/483329" } ] } ```