# SeatGeek > Search live events with SeatGeek's Platform API: concerts, sport, theatre, comedy and festivals across the United States and Canada. Find what is on near a place or in a city, follow a band's tour or a team's fixtures, watch a venue's diary, filter by what the tickets actually cost, be told when a new date is announced, and ask SeatGeek what else the same person would like. App · Events · 17 actions. Web page: https://docs.lodol.com/docs/integrations/seatgeek ## Actions ### Count events Count how many events match a search, and return the soonest 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 a performer adds dates. **Inputs** - Search for (`query`, text): Optional. Words to search on: an artist, a team, a show, a venue or a city. This searches everything about an event at once, so 'madison' finds Madison Square Garden and events in Madison, WI. Leave it empty to browse by the filters below alone. - City (`venue_city`, text): Optional. Only include events at venues in this city. - State or province (`venue_state`, text): Optional. Only include events in this US state or Canadian province. One of: `AL` (Alabama (US)), `AK` (Alaska (US)), `AB` (Alberta (Canada)), `AS` (American Samoa (US)), `AZ` (Arizona (US)), `AR` (Arkansas (US)), `BC` (British Columbia (Canada)), `CA` (California (US)), `CO` (Colorado (US)), `CT` (Connecticut (US)), and 59 more. - Country (`venue_country`, text): Optional. Only include events in this country. SeatGeek's catalogue is deepest in the United States and Canada. One of: `US` (United States), `CA` (Canada), `GB` (United Kingdom), `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), and 239 more. - Venue IDs (`venue_ids`, list): Optional. Only include events at these venues. Add more than one to cover several. Venue IDs come from Search venues. - Performer IDs (`performer_ids`, list): Optional. Only include events featuring these performers. Add more than one to match any of them. Performer IDs come from Search performers. - Performer slug (`performer_slug`, text): Optional. Only include events featuring this performer, named by the slug in their seatgeek.com address: the part after the domain and before '-tickets'. - Category (`taxonomy_id`, text): Optional. Only include events in this category: sport, concerts, theatre and so on. The list is read from SeatGeek, so it is always the current one. - Subcategory (`subtaxonomy_id`, text): Optional. Narrow the category further: NBA inside sport, or music festivals inside concerts. Choose a category first; this list is the subcategories inside it. When set, this wins over the category above. - Starting after (`start_after`, date and time): Optional. Only include events starting at or after this moment. Pick a date and time; it is sent to SeatGeek in UTC. - Starting before (`start_before`, date and time): Optional. Only include events starting at or before this moment. Pair it with 'Starting after' to search one window. - Only events with tickets on sale (`only_with_tickets`, true/false): Skip events that currently have no ticket listings. SeatGeek lists events before any seller has posted tickets, so this is what keeps a 'go and buy' message from linking to an empty page. Default: `false`. **Outputs** - `first_event` (object): The soonest matching event - `has_events` (true/false): Whether anything matched at all - `performer_slug` (text): The performer slug that was filtered on - `query` (text): The words that were searched for - `start_after` (text): The earliest start time that was allowed, in UTC - `start_before` (text): The latest start time that was allowed, in UTC - `taxonomy_id` (text): The category ID the search was filtered on - `taxonomy_level` (text): Whether that ID was the category or the subcategory - `total_count` (number): How many events match - `venue_city` (text): The city that was filtered on - `venue_country` (text): The country that was filtered on - `venue_postal_code` (text): The venue postcode that was filtered on - `venue_state` (text): The state that was filtered on **Example output** ```json { "first_event": { "announce_date": "2026-04-12T00:00:00", "average_price": 97, "away_team": null, "category": "Concert", "date_local": "2026-09-09", "date_tbd": false, "datetime_local": "2026-09-09T19:00:00", "datetime_utc": "2026-09-09T23:00:00", "has_tickets": true, "highest_price": 296, "home_team": null, "id": 721901, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "listing_count": 161, "lowest_price": 62, "median_price": 88, "performer_names": [ "Young the Giant", "Grouplove" ], "performers": [ { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "role": "primary", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" }, { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" } ], "has_upcoming_events": true, "id": 8987, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Grouplove", "num_upcoming_events": 14, "primary_genre": "Alternative", "role": "performer", "score": 0.54, "short_name": "Grouplove", "slug": "grouplove", "spotify_url": null, "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/grouplove-tickets" } ], "primary_performer": "Young the Giant", "score": 0.66, "short_title": "Young the Giant", "starts_display": "2026-09-09 19:00", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null }, { "display_name": "Music Festival", "id": 2010000, "name": "music_festival", "parent_id": 2000000 } ], "taxonomy_names": [ "concert", "music_festival" ], "time_local": "19:00", "time_tbd": false, "title": "Young the Giant with Grouplove", "type": "concert", "url": "https://seatgeek.com/young-the-giant-with-grouplove-tickets/new-york-new-york-terminal-5-2026-09-09/concert/721901", "venue": { "address": "610 W 56th St", "capacity": 3000, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 814, "latitude": 40.77167, "longitude": -73.99277, "name": "Terminal 5", "num_upcoming_events": 48, "postal_code": "10019", "score": 0.62, "slug": "terminal-5", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/terminal-5/tickets" }, "venue_address": "610 W 56th St", "venue_city": "New York", "venue_country": "US", "venue_id": 814, "venue_latitude": 40.77167, "venue_location": "New York, NY", "venue_longitude": -73.99277, "venue_name": "Terminal 5", "venue_postal_code": "10019", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/terminal-5/tickets", "visible_until": "2026-09-10T05:00:00" }, "has_events": true, "query": "young the giant", "start_after": "2026-09-01T00:00:00", "start_before": "2026-12-01T00:00:00", "total_count": 26, "venue_state": "NY" } ``` ### Find events near a location Find events within a distance of a point on the map. Give a latitude and a longitude in plain degrees and a radius in miles or kilometres, and narrow it further by keyword, category, dates or whether tickets are actually on sale. 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. Positive is north of the equator. From -90 to 90. - Longitude (`longitude`, number, required): The longitude of the point to search around, in degrees. Negative is west of Greenwich, which is all of the Americas. From -180 to 180. - Within (`search_range`, number): How far from that point to search, in the unit chosen below. Defaults to 30. From 1 to 25000. Default: `30`. - Distance unit (`range_unit`, text): Whether the distance above is in miles or kilometres. One of: `mi` (Miles), `km` (Kilometres). Default: `mi`. - Search for (`query`, text): Optional. Words to search on: an artist, a team, a show, a venue or a city. This searches everything about an event at once, so 'madison' finds Madison Square Garden and events in Madison, WI. Leave it empty to browse by the filters below alone. - Category (`taxonomy_id`, text): Optional. Only include events in this category: sport, concerts, theatre and so on. The list is read from SeatGeek, so it is always the current one. - Subcategory (`subtaxonomy_id`, text): Optional. Narrow the category further: NBA inside sport, or music festivals inside concerts. Choose a category first; this list is the subcategories inside it. When set, this wins over the category above. - Starting after (`start_after`, date and time): Optional. Only include events starting at or after this moment. Pick a date and time; it is sent to SeatGeek in UTC. - Starting before (`start_before`, date and time): Optional. Only include events starting at or before this moment. Pair it with 'Starting after' to search one window. - Only events with tickets on sale (`only_with_tickets`, true/false): Skip events that currently have no ticket listings. SeatGeek lists events before any seller has posted tickets, so this is what keeps a 'go and buy' message from linking to an empty page. Default: `false`. - Order by (`sort`, text): What order to return the events in. One of: `datetime_utc.asc` (Soonest first), `datetime_utc.desc` (Furthest ahead first), `datetime_local.asc` (Soonest first, by the venue's local clock), `datetime_local.desc` (Furthest ahead first, by the venue's local clock), `announce_date.desc` (Most recently announced first), `announce_date.asc` (Longest announced first), `score.desc` (Most popular first), `score.asc` (Least popular first), `id.asc` (Lowest event ID first), `id.desc` (Highest event ID first). Default: `datetime_utc.asc`. - How many to return (`per_page`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`. - Page (`page`, number): Which page of results to return. The first page is 1. The answer says how many pages there are, so a loop can ask for the next one. From 1 to 100000. Default: `1`. **Outputs** - `events` (list): The events that matched - `geolocated_latitude` (number): The latitude SeatGeek resolved the location to - `geolocated_longitude` (number): The longitude SeatGeek resolved the location to - `geolocated_range` (text): The range SeatGeek applied - `has_more` (true/false): Whether there is another page after this one - `page` (number): Which page this is - `per_page` (number): The page size that was used - `query` (text): The words that were searched for - `returned_count` (number): How many results came back on this page - `searched_latitude` (number): The latitude searched around - `searched_longitude` (number): The longitude searched around - `searched_postal_code` (text): The postcode searched around - `searched_range` (text): The distance searched, with its unit (e.g. 25mi) - `searched_range_unit` (text): That distance's unit - `searched_range_value` (number): That distance as a number - `sort` (text): The ordering that was applied - `sort_label` (text): That ordering, written out - `start_after` (text): The earliest start time that was allowed, in UTC - `start_before` (text): The latest start time that was allowed, in UTC - `taxonomy_id` (text): The category ID the search was filtered on - `taxonomy_level` (text): Whether that ID was the category or the subcategory - `total_count` (number): How many results match in total, across every page - `total_pages` (number): How many pages there are **Example output** ```json { "events": [ { "announce_date": "2026-04-12T00:00:00", "average_price": 97, "away_team": null, "category": "Concert", "date_local": "2026-09-09", "date_tbd": false, "datetime_local": "2026-09-09T19:00:00", "datetime_utc": "2026-09-09T23:00:00", "has_tickets": true, "highest_price": 296, "home_team": null, "id": 721901, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "listing_count": 161, "lowest_price": 62, "median_price": 88, "performer_names": [ "Young the Giant", "Grouplove" ], "performers": [ { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "role": "primary", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" }, { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" } ], "has_upcoming_events": true, "id": 8987, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Grouplove", "num_upcoming_events": 14, "primary_genre": "Alternative", "role": "performer", "score": 0.54, "short_name": "Grouplove", "slug": "grouplove", "spotify_url": null, "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/grouplove-tickets" } ], "primary_performer": "Young the Giant", "score": 0.66, "short_title": "Young the Giant", "starts_display": "2026-09-09 19:00", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null }, { "display_name": "Music Festival", "id": 2010000, "name": "music_festival", "parent_id": 2000000 } ], "taxonomy_names": [ "concert", "music_festival" ], "time_local": "19:00", "time_tbd": false, "title": "Young the Giant with Grouplove", "type": "concert", "url": "https://seatgeek.com/young-the-giant-with-grouplove-tickets/new-york-new-york-terminal-5-2026-09-09/concert/721901", "venue": { "address": "610 W 56th St", "capacity": 3000, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 814, "latitude": 40.77167, "longitude": -73.99277, "name": "Terminal 5", "num_upcoming_events": 48, "postal_code": "10019", "score": 0.62, "slug": "terminal-5", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/terminal-5/tickets" }, "venue_address": "610 W 56th St", "venue_city": "New York", "venue_country": "US", "venue_id": 814, "venue_latitude": 40.77167, "venue_location": "New York, NY", "venue_longitude": -73.99277, "venue_name": "Terminal 5", "venue_postal_code": "10019", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/terminal-5/tickets", "visible_until": "2026-09-10T05:00:00" }, { "announce_date": "2026-08-15T00:00:00", "average_price": 212, "away_team": "Brooklyn Nets", "category": "Sports", "date_local": "2026-11-14", "date_tbd": false, "datetime_local": "2026-11-14T19:30:00", "datetime_utc": "2026-11-15T00:30:00", "has_tickets": true, "highest_price": 3500, "home_team": "New York Knicks", "id": 6154772, "image": "https://seatgeek.com/images/performers-landscape/new-york-knicks.jpg", "listing_count": 940, "lowest_price": 48, "median_price": null, "performer_names": [ "New York Knicks", "Brooklyn Nets" ], "performers": [ { "category": "Sports", "division_names": [ "Eastern Conference", "Atlantic Division" ], "divisions": [ { "id": 1, "name": "Eastern Conference", "slug": "eastern-conference", "type": "conference" }, { "id": 2, "name": "Atlantic Division", "slug": "atlantic-division", "type": "division" } ], "genre_names": [], "genres": [], "has_upcoming_events": true, "id": 2090, "image": "https://seatgeek.com/images/performers-landscape/new-york-knicks.jpg", "image_huge": "https://seatgeek.com/images/performers/2090/huge.jpg", "image_large": "https://seatgeek.com/images/performers/2090/large.jpg", "image_medium": "https://seatgeek.com/images/performers/2090/medium.jpg", "image_small": "https://seatgeek.com/images/performers/2090/small.jpg", "lastfm_url": null, "links": [], "name": "New York Knicks", "num_upcoming_events": 41, "primary_genre": null, "role": "home_team", "score": 0.88, "short_name": "Knicks", "slug": "new-york-knicks", "spotify_url": null, "taxonomies": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null }, { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "sports", "nba" ], "type": "nba_team", "url": "https://seatgeek.com/new-york-knicks-tickets" }, { "category": null, "division_names": [], "divisions": [], "genre_names": [], "genres": [], "has_upcoming_events": null, "id": 2091, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Brooklyn Nets", "num_upcoming_events": null, "primary_genre": null, "role": "away_team", "score": 0.74, "short_name": null, "slug": "brooklyn-nets", "spotify_url": null, "taxonomies": [ { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "nba" ], "type": "nba_team", "url": null } ], "primary_performer": "New York Knicks", "score": 0.81, "short_title": "Knicks at Nets", "starts_display": "2026-11-14 19:30", "taxonomies": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null }, { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "sports", "nba" ], "time_local": "19:30", "time_tbd": false, "title": "New York Knicks at Brooklyn Nets", "type": "nba", "url": "https://seatgeek.com/new-york-knicks-at-brooklyn-nets-tickets/6154772", "venue": { "address": "4 Pennsylvania Plaza", "capacity": null, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 3120, "latitude": 40.7505, "longitude": -73.9934, "name": "Madison Square Garden", "num_upcoming_events": 213, "postal_code": "10001", "score": 0.99, "slug": "madison-square-garden", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/madison-square-garden/tickets" }, "venue_address": "4 Pennsylvania Plaza", "venue_city": "New York", "venue_country": "US", "venue_id": 3120, "venue_latitude": 40.7505, "venue_location": "New York, NY", "venue_longitude": -73.9934, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/madison-square-garden/tickets", "visible_until": null } ], "geolocated_latitude": 40.7128, "geolocated_longitude": -74.006, "geolocated_range": "25mi", "has_more": false, "page": 1, "per_page": 10, "returned_count": 2, "searched_latitude": 40.7128, "searched_longitude": -74.006, "searched_range": "25mi", "searched_range_unit": "mi", "searched_range_value": 25, "sort": "datetime_utc.asc", "sort_label": "Soonest first", "total_count": 2, "total_pages": 1 } ``` ### Find newly announced events Find the events SeatGeek has added most recently, and keep only the ones announced inside the window you choose. This is the alert to put on a schedule: run it each morning for your city or your favourite category and hear about a new date while there are still good seats. **Inputs** - Announced within (`window`, text): How far back to look for newly announced events, counted from the moment this step runs. One of: `24_hours` (Announced in the last 24 hours), `3_days` (Announced in the last 3 days), `7_days` (Announced in the last 7 days), `14_days` (Announced in the last 14 days), `30_days` (Announced in the last 30 days). Default: `7_days`. - Search for (`query`, text): Optional. Words to search on: an artist, a team, a show, a venue or a city. This searches everything about an event at once, so 'madison' finds Madison Square Garden and events in Madison, WI. Leave it empty to browse by the filters below alone. - City (`venue_city`, text): Optional. Only include events at venues in this city. - State or province (`venue_state`, text): Optional. Only include events in this US state or Canadian province. One of: `AL` (Alabama (US)), `AK` (Alaska (US)), `AB` (Alberta (Canada)), `AS` (American Samoa (US)), `AZ` (Arizona (US)), `AR` (Arkansas (US)), `BC` (British Columbia (Canada)), `CA` (California (US)), `CO` (Colorado (US)), `CT` (Connecticut (US)), and 59 more. - Country (`venue_country`, text): Optional. Only include events in this country. SeatGeek's catalogue is deepest in the United States and Canada. One of: `US` (United States), `CA` (Canada), `GB` (United Kingdom), `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), and 239 more. - Category (`taxonomy_id`, text): Optional. Only include events in this category: sport, concerts, theatre and so on. The list is read from SeatGeek, so it is always the current one. - Subcategory (`subtaxonomy_id`, text): Optional. Narrow the category further: NBA inside sport, or music festivals inside concerts. Choose a category first; this list is the subcategories inside it. When set, this wins over the category above. - Only events with tickets on sale (`only_with_tickets`, true/false): Skip events that currently have no ticket listings. SeatGeek lists events before any seller has posted tickets, so this is what keeps a 'go and buy' message from linking to an empty page. Default: `false`. - How many to return (`per_page`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`. **Outputs** - `announced_after` (text): The earliest announcement time that was kept, in UTC - `events` (list): The events announced inside the window - `page` (number): Which page was read - `per_page` (number): The page size that was used - `query` (text): The words that were searched for - `read_count` (number): How many of the most recently announced events were read to find them - `returned_count` (number): How many events were announced inside the window - `taxonomy_id` (text): The category ID the search was filtered on - `taxonomy_level` (text): Whether that ID was the category or the subcategory - `total_count` (number): How many upcoming events match the filters in total - `venue_city` (text): The city that was filtered on - `venue_country` (text): The country that was filtered on - `venue_postal_code` (text): The venue postcode that was filtered on - `venue_state` (text): The state that was filtered on - `window` (text): The window that was asked for - `window_label` (text): That window, written out **Example output** ```json { "announced_after": "2026-08-19T12:00:00", "events": [ { "announce_date": "2026-08-15T00:00:00", "average_price": 212, "away_team": "Brooklyn Nets", "category": "Sports", "date_local": "2026-11-14", "date_tbd": false, "datetime_local": "2026-11-14T19:30:00", "datetime_utc": "2026-11-15T00:30:00", "has_tickets": true, "highest_price": 3500, "home_team": "New York Knicks", "id": 6154772, "image": "https://seatgeek.com/images/performers-landscape/new-york-knicks.jpg", "listing_count": 940, "lowest_price": 48, "median_price": null, "performer_names": [ "New York Knicks", "Brooklyn Nets" ], "performers": [ { "category": "Sports", "division_names": [ "Eastern Conference", "Atlantic Division" ], "divisions": [ { "id": 1, "name": "Eastern Conference", "slug": "eastern-conference", "type": "conference" }, { "id": 2, "name": "Atlantic Division", "slug": "atlantic-division", "type": "division" } ], "genre_names": [], "genres": [], "has_upcoming_events": true, "id": 2090, "image": "https://seatgeek.com/images/performers-landscape/new-york-knicks.jpg", "image_huge": "https://seatgeek.com/images/performers/2090/huge.jpg", "image_large": "https://seatgeek.com/images/performers/2090/large.jpg", "image_medium": "https://seatgeek.com/images/performers/2090/medium.jpg", "image_small": "https://seatgeek.com/images/performers/2090/small.jpg", "lastfm_url": null, "links": [], "name": "New York Knicks", "num_upcoming_events": 41, "primary_genre": null, "role": "home_team", "score": 0.88, "short_name": "Knicks", "slug": "new-york-knicks", "spotify_url": null, "taxonomies": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null }, { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "sports", "nba" ], "type": "nba_team", "url": "https://seatgeek.com/new-york-knicks-tickets" }, { "category": null, "division_names": [], "divisions": [], "genre_names": [], "genres": [], "has_upcoming_events": null, "id": 2091, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Brooklyn Nets", "num_upcoming_events": null, "primary_genre": null, "role": "away_team", "score": 0.74, "short_name": null, "slug": "brooklyn-nets", "spotify_url": null, "taxonomies": [ { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "nba" ], "type": "nba_team", "url": null } ], "primary_performer": "New York Knicks", "score": 0.81, "short_title": "Knicks at Nets", "starts_display": "2026-11-14 19:30", "taxonomies": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null }, { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "sports", "nba" ], "time_local": "19:30", "time_tbd": false, "title": "New York Knicks at Brooklyn Nets", "type": "nba", "url": "https://seatgeek.com/new-york-knicks-at-brooklyn-nets-tickets/6154772", "venue": { "address": "4 Pennsylvania Plaza", "capacity": null, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 3120, "latitude": 40.7505, "longitude": -73.9934, "name": "Madison Square Garden", "num_upcoming_events": 213, "postal_code": "10001", "score": 0.99, "slug": "madison-square-garden", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/madison-square-garden/tickets" }, "venue_address": "4 Pennsylvania Plaza", "venue_city": "New York", "venue_country": "US", "venue_id": 3120, "venue_latitude": 40.7505, "venue_location": "New York, NY", "venue_longitude": -73.9934, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/madison-square-garden/tickets", "visible_until": null } ], "page": 1, "per_page": 10, "read_count": 10, "returned_count": 1, "total_count": 4213, "venue_state": "NY", "window": "7_days", "window_label": "Announced in the last 7 days" } ``` ### Find venues near a location Find the venues within a distance of a point on the map, most popular first. Give a latitude and a longitude in plain degrees. This is how a workflow answers 'which rooms are near this address' before asking any of them what is on. **Inputs** - Latitude (`latitude`, number, required): The latitude of the point to search around, in degrees. Positive is north of the equator. From -90 to 90. - Longitude (`longitude`, number, required): The longitude of the point to search around, in degrees. Negative is west of Greenwich, which is all of the Americas. From -180 to 180. - Within (`search_range`, number): How far from that point to search, in the unit chosen below. Defaults to 30. From 1 to 25000. Default: `30`. - Distance unit (`range_unit`, text): Whether the distance above is in miles or kilometres. One of: `mi` (Miles), `km` (Kilometres). Default: `mi`. - Search for (`query`, text): Optional. Words to search venues on: part of a name, or a place. Leave it empty to browse by the filters below alone. - How many to return (`per_page`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`. - Page (`page`, number): Which page of results to return. The first page is 1. The answer says how many pages there are, so a loop can ask for the next one. From 1 to 100000. Default: `1`. **Outputs** - `geolocated_latitude` (number): The latitude SeatGeek resolved the location to - `geolocated_longitude` (number): The longitude SeatGeek resolved the location to - `geolocated_range` (text): The range SeatGeek applied - `has_more` (true/false): Whether there is another page after this one - `page` (number): Which page this is - `per_page` (number): The page size that was used - `query` (text): The words that were searched for - `returned_count` (number): How many results came back on this page - `searched_latitude` (number): The latitude searched around - `searched_longitude` (number): The longitude searched around - `searched_postal_code` (text): The postcode searched around - `searched_range` (text): The distance searched, with its unit (e.g. 25mi) - `searched_range_unit` (text): That distance's unit - `searched_range_value` (number): That distance as a number - `total_count` (number): How many results match in total, across every page - `total_pages` (number): How many pages there are - `venues` (list): The venues that matched **Example output** ```json { "geolocated_latitude": 40.7128, "geolocated_longitude": -74.006, "geolocated_range": "10mi", "has_more": false, "page": 1, "per_page": 10, "returned_count": 2, "searched_latitude": 40.7128, "searched_longitude": -74.006, "searched_range": "10mi", "searched_range_unit": "mi", "searched_range_value": 10, "total_count": 2, "total_pages": 1, "venues": [ { "address": "610 W 56th St", "capacity": 3000, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 814, "latitude": 40.77167, "longitude": -73.99277, "name": "Terminal 5", "num_upcoming_events": 48, "postal_code": "10019", "score": 0.62, "slug": "terminal-5", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/terminal-5/tickets" }, { "address": "4 Pennsylvania Plaza", "capacity": null, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 3120, "latitude": 40.7505, "longitude": -73.9934, "name": "Madison Square Garden", "num_upcoming_events": 213, "postal_code": "10001", "score": 0.99, "slug": "madison-square-garden", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/madison-square-garden/tickets" } ] } ``` ### Get event details Read one event in full: the venue and its address and coordinates, who is playing and in what role, the local start time, how many tickets are listed and what the cheapest, average and dearest cost, and the link to buy. **Inputs** - Event ID (`event_id`, number, required): The event to read, by its SeatGeek ID. Event IDs come from any of the event search actions. At least 1. **Outputs** - `announce_date` (text): When the event was announced - `average_price` (number): Average listing price, in USD - `away_team` (text): The away team, for a fixture - `category` (text): The top-level category the event is filed under - `date_local` (text): The local date alone (YYYY-MM-DD) - `date_tbd` (true/false): True when even the date is an estimate - `datetime_local` (text): When it starts, on the venue's clock - `datetime_utc` (text): When it starts, in UTC - `has_tickets` (true/false): Whether anyone is currently selling tickets - `highest_price` (number): Dearest ticket, in USD - `home_team` (text): The home team, for a fixture - `id` (number): SeatGeek's ID for the event - `image` (text): A picture for the event - `listing_count` (number): How many ticket listings there are - `lowest_price` (number): Cheapest ticket, in USD - `median_price` (number): Median listing price, in USD - `performer_names` (list): Everyone playing, by name - `performers` (list): The line-up in full, each with their role - `primary_performer` (text): The headliner, or the first performer listed - `score` (number): SeatGeek's popularity ranking - `short_title` (text): A shortened title - `starts_display` (text): When it starts, ready to print, and saying so when the date or time is still to be confirmed - `taxonomies` (list): The categories the event is filed under, in full - `taxonomy_names` (list): Every category slug the event is filed under - `time_local` (text): The local start time alone (HH:MM), empty when the time is not set - `time_tbd` (true/false): True when the start time is not set yet - `title` (text): The event's full title - `type` (text): What kind of event this is - `url` (text): The event's page on seatgeek.com: where to buy tickets - `venue` (object): The venue in full - `venue_address` (text): Venue street address - `venue_city` (text): Venue city - `venue_country` (text): Venue country code - `venue_id` (number): The venue's SeatGeek ID - `venue_latitude` (number): Venue latitude - `venue_location` (text): Venue city and state as one line - `venue_longitude` (number): Venue longitude - `venue_name` (text): Venue name - `venue_postal_code` (text): Venue postcode - `venue_state` (text): Venue state or province - `venue_url` (text): The venue's page on seatgeek.com - `visible_until` (text): When SeatGeek stops showing this event **Example output** ```json { "announce_date": "2026-04-12T00:00:00", "average_price": 97, "away_team": null, "category": "Concert", "date_local": "2026-09-09", "date_tbd": false, "datetime_local": "2026-09-09T19:00:00", "datetime_utc": "2026-09-09T23:00:00", "has_tickets": true, "highest_price": 296, "home_team": null, "id": 721901, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "listing_count": 161, "lowest_price": 62, "median_price": 88, "performer_names": [ "Young the Giant", "Grouplove" ], "performers": [ { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "role": "primary", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" }, { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" } ], "has_upcoming_events": true, "id": 8987, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Grouplove", "num_upcoming_events": 14, "primary_genre": "Alternative", "role": "performer", "score": 0.54, "short_name": "Grouplove", "slug": "grouplove", "spotify_url": null, "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/grouplove-tickets" } ], "primary_performer": "Young the Giant", "score": 0.66, "short_title": "Young the Giant", "starts_display": "2026-09-09 19:00", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null }, { "display_name": "Music Festival", "id": 2010000, "name": "music_festival", "parent_id": 2000000 } ], "taxonomy_names": [ "concert", "music_festival" ], "time_local": "19:00", "time_tbd": false, "title": "Young the Giant with Grouplove", "type": "concert", "url": "https://seatgeek.com/young-the-giant-with-grouplove-tickets/new-york-new-york-terminal-5-2026-09-09/concert/721901", "venue": { "address": "610 W 56th St", "capacity": 3000, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 814, "latitude": 40.77167, "longitude": -73.99277, "name": "Terminal 5", "num_upcoming_events": 48, "postal_code": "10019", "score": 0.62, "slug": "terminal-5", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/terminal-5/tickets" }, "venue_address": "610 W 56th St", "venue_city": "New York", "venue_country": "US", "venue_id": 814, "venue_latitude": 40.77167, "venue_location": "New York, NY", "venue_longitude": -73.99277, "venue_name": "Terminal 5", "venue_postal_code": "10019", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/terminal-5/tickets", "visible_until": "2026-09-10T05:00:00" } ``` ### Get events at a venue List what is on at one venue, soonest first. The venue ID comes from Search venues or from any event's venue_id, 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`, number, required): The venue, by its SeatGeek ID. Venue IDs come from Search venues, and from the 'venue_id' field on any event. At least 1. - Search for (`query`, text): Optional. Words to search on: an artist, a team, a show, a venue or a city. This searches everything about an event at once, so 'madison' finds Madison Square Garden and events in Madison, WI. Leave it empty to browse by the filters below alone. - Category (`taxonomy_id`, text): Optional. Only include events in this category: sport, concerts, theatre and so on. The list is read from SeatGeek, so it is always the current one. - Subcategory (`subtaxonomy_id`, text): Optional. Narrow the category further: NBA inside sport, or music festivals inside concerts. Choose a category first; this list is the subcategories inside it. When set, this wins over the category above. - Starting after (`start_after`, date and time): Optional. Only include events starting at or after this moment. Pick a date and time; it is sent to SeatGeek in UTC. - Starting before (`start_before`, date and time): Optional. Only include events starting at or before this moment. Pair it with 'Starting after' to search one window. - Only events with tickets on sale (`only_with_tickets`, true/false): Skip events that currently have no ticket listings. SeatGeek lists events before any seller has posted tickets, so this is what keeps a 'go and buy' message from linking to an empty page. Default: `false`. - Order by (`sort`, text): What order to return the events in. One of: `datetime_utc.asc` (Soonest first), `datetime_utc.desc` (Furthest ahead first), `datetime_local.asc` (Soonest first, by the venue's local clock), `datetime_local.desc` (Furthest ahead first, by the venue's local clock), `announce_date.desc` (Most recently announced first), `announce_date.asc` (Longest announced first), `score.desc` (Most popular first), `score.asc` (Least popular first), `id.asc` (Lowest event ID first), `id.desc` (Highest event ID first). Default: `datetime_utc.asc`. - How many to return (`per_page`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`. - Page (`page`, number): Which page of results to return. The first page is 1. The answer says how many pages there are, so a loop can ask for the next one. From 1 to 100000. Default: `1`. **Outputs** - `events` (list): The events that matched - `has_more` (true/false): Whether there is another page after this one - `page` (number): Which page this is - `per_page` (number): The page size that was used - `query` (text): The words that were searched for - `returned_count` (number): How many results came back on this page - `sort` (text): The ordering that was applied - `sort_label` (text): That ordering, written out - `start_after` (text): The earliest start time that was allowed, in UTC - `start_before` (text): The latest start time that was allowed, in UTC - `taxonomy_id` (text): The category ID the search was filtered on - `taxonomy_level` (text): Whether that ID was the category or the subcategory - `total_count` (number): How many results match in total, across every page - `total_pages` (number): How many pages there are - `venue_id` (number): The venue that was read - `venue_location` (text): That venue's city and state - `venue_name` (text): That venue's name, read off the events **Example output** ```json { "events": [ { "announce_date": "2026-04-12T00:00:00", "average_price": 97, "away_team": null, "category": "Concert", "date_local": "2026-09-09", "date_tbd": false, "datetime_local": "2026-09-09T19:00:00", "datetime_utc": "2026-09-09T23:00:00", "has_tickets": true, "highest_price": 296, "home_team": null, "id": 721901, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "listing_count": 161, "lowest_price": 62, "median_price": 88, "performer_names": [ "Young the Giant", "Grouplove" ], "performers": [ { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "role": "primary", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" }, { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" } ], "has_upcoming_events": true, "id": 8987, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Grouplove", "num_upcoming_events": 14, "primary_genre": "Alternative", "role": "performer", "score": 0.54, "short_name": "Grouplove", "slug": "grouplove", "spotify_url": null, "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/grouplove-tickets" } ], "primary_performer": "Young the Giant", "score": 0.66, "short_title": "Young the Giant", "starts_display": "2026-09-09 19:00", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null }, { "display_name": "Music Festival", "id": 2010000, "name": "music_festival", "parent_id": 2000000 } ], "taxonomy_names": [ "concert", "music_festival" ], "time_local": "19:00", "time_tbd": false, "title": "Young the Giant with Grouplove", "type": "concert", "url": "https://seatgeek.com/young-the-giant-with-grouplove-tickets/new-york-new-york-terminal-5-2026-09-09/concert/721901", "venue": { "address": "610 W 56th St", "capacity": 3000, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 814, "latitude": 40.77167, "longitude": -73.99277, "name": "Terminal 5", "num_upcoming_events": 48, "postal_code": "10019", "score": 0.62, "slug": "terminal-5", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/terminal-5/tickets" }, "venue_address": "610 W 56th St", "venue_city": "New York", "venue_country": "US", "venue_id": 814, "venue_latitude": 40.77167, "venue_location": "New York, NY", "venue_longitude": -73.99277, "venue_name": "Terminal 5", "venue_postal_code": "10019", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/terminal-5/tickets", "visible_until": "2026-09-10T05:00:00" } ], "has_more": false, "page": 1, "per_page": 10, "returned_count": 1, "sort": "datetime_utc.asc", "sort_label": "Soonest first", "total_count": 48, "total_pages": 1, "venue_id": 814, "venue_location": "New York, NY", "venue_name": "Terminal 5" } ``` ### Get events for a performer List every date an artist, team or show is playing. A tour is one performer with many events, so this is what turns 'Vampire Weekend' into their tour dates. Identify them by ID or by slug, narrow it to a state or a country to answer 'are they playing near me', and for a team split it into home games and away games. **Inputs** - Performer ID (`performer_id`, number): The performer whose dates you want, by their SeatGeek ID. Give this or the slug below. At least 1. - Performer slug (`performer_slug`, text): The performer's slug, if you have that rather than an ID: the part of their seatgeek.com address before '-tickets'. Give this or the ID above. - Playing as (`performer_role`, text): Which role the performer has to have at the event. 'As the headliner' skips the dates where they are the support act; the two team roles split a fixture into home games and away games. One of: `any` (In any role), `primary` (As the headliner), `home_team` (As the home team), `away_team` (As the away team). Default: `any`. - City (`venue_city`, text): Optional. Only include events at venues in this city. - State or province (`venue_state`, text): Optional. Only include events in this US state or Canadian province. One of: `AL` (Alabama (US)), `AK` (Alaska (US)), `AB` (Alberta (Canada)), `AS` (American Samoa (US)), `AZ` (Arizona (US)), `AR` (Arkansas (US)), `BC` (British Columbia (Canada)), `CA` (California (US)), `CO` (Colorado (US)), `CT` (Connecticut (US)), and 59 more. - Country (`venue_country`, text): Optional. Only include events in this country. SeatGeek's catalogue is deepest in the United States and Canada. One of: `US` (United States), `CA` (Canada), `GB` (United Kingdom), `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), and 239 more. - Starting after (`start_after`, date and time): Optional. Only include events starting at or after this moment. Pick a date and time; it is sent to SeatGeek in UTC. - Starting before (`start_before`, date and time): Optional. Only include events starting at or before this moment. Pair it with 'Starting after' to search one window. - Only events with tickets on sale (`only_with_tickets`, true/false): Skip events that currently have no ticket listings. SeatGeek lists events before any seller has posted tickets, so this is what keeps a 'go and buy' message from linking to an empty page. Default: `false`. - Order by (`sort`, text): What order to return the events in. One of: `datetime_utc.asc` (Soonest first), `datetime_utc.desc` (Furthest ahead first), `datetime_local.asc` (Soonest first, by the venue's local clock), `datetime_local.desc` (Furthest ahead first, by the venue's local clock), `announce_date.desc` (Most recently announced first), `announce_date.asc` (Longest announced first), `score.desc` (Most popular first), `score.asc` (Least popular first), `id.asc` (Lowest event ID first), `id.desc` (Highest event ID first). Default: `datetime_utc.asc`. - How many to return (`per_page`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`. - Page (`page`, number): Which page of results to return. The first page is 1. The answer says how many pages there are, so a loop can ask for the next one. From 1 to 100000. Default: `1`. **Outputs** - `events` (list): The events that matched - `has_more` (true/false): Whether there is another page after this one - `page` (number): Which page this is - `per_page` (number): The page size that was used - `performer_id` (number): The performer that was read - `performer_name` (text): That performer's name, read off the line-ups - `performer_role` (text): The role that was required - `performer_role_label` (text): That role, written out - `performer_slug` (text): The slug that was read, when one was given - `returned_count` (number): How many results came back on this page - `sort` (text): The ordering that was applied - `sort_label` (text): That ordering, written out - `start_after` (text): The earliest start time that was allowed, in UTC - `start_before` (text): The latest start time that was allowed, in UTC - `total_count` (number): How many results match in total, across every page - `total_pages` (number): How many pages there are - `venue_city` (text): The city that was filtered on - `venue_country` (text): The country that was filtered on - `venue_postal_code` (text): The venue postcode that was filtered on - `venue_state` (text): The state that was filtered on **Example output** ```json { "events": [ { "announce_date": "2026-04-12T00:00:00", "average_price": 97, "away_team": null, "category": "Concert", "date_local": "2026-09-09", "date_tbd": false, "datetime_local": "2026-09-09T19:00:00", "datetime_utc": "2026-09-09T23:00:00", "has_tickets": true, "highest_price": 296, "home_team": null, "id": 721901, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "listing_count": 161, "lowest_price": 62, "median_price": 88, "performer_names": [ "Young the Giant", "Grouplove" ], "performers": [ { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "role": "primary", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" }, { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" } ], "has_upcoming_events": true, "id": 8987, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Grouplove", "num_upcoming_events": 14, "primary_genre": "Alternative", "role": "performer", "score": 0.54, "short_name": "Grouplove", "slug": "grouplove", "spotify_url": null, "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/grouplove-tickets" } ], "primary_performer": "Young the Giant", "score": 0.66, "short_title": "Young the Giant", "starts_display": "2026-09-09 19:00", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null }, { "display_name": "Music Festival", "id": 2010000, "name": "music_festival", "parent_id": 2000000 } ], "taxonomy_names": [ "concert", "music_festival" ], "time_local": "19:00", "time_tbd": false, "title": "Young the Giant with Grouplove", "type": "concert", "url": "https://seatgeek.com/young-the-giant-with-grouplove-tickets/new-york-new-york-terminal-5-2026-09-09/concert/721901", "venue": { "address": "610 W 56th St", "capacity": 3000, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 814, "latitude": 40.77167, "longitude": -73.99277, "name": "Terminal 5", "num_upcoming_events": 48, "postal_code": "10019", "score": 0.62, "slug": "terminal-5", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/terminal-5/tickets" }, "venue_address": "610 W 56th St", "venue_city": "New York", "venue_country": "US", "venue_id": 814, "venue_latitude": 40.77167, "venue_location": "New York, NY", "venue_longitude": -73.99277, "venue_name": "Terminal 5", "venue_postal_code": "10019", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/terminal-5/tickets", "visible_until": "2026-09-10T05:00:00" } ], "has_more": false, "page": 1, "per_page": 10, "performer_id": 8741, "performer_name": "Young the Giant", "performer_role": "any", "performer_role_label": "In any role", "returned_count": 1, "sort": "datetime_utc.asc", "sort_label": "Soonest first", "total_count": 26, "total_pages": 1 } ``` ### Get performer by slug Read one performer by the readable name in their seatgeek.com address, such as 'new-york-mets'. Use this when a workflow has a SeatGeek link rather than an ID: it turns the link into the performer, and so into their ID. **Inputs** - Performer slug (`slug`, text, required): The performer's slug: the readable name in their seatgeek.com address. For https://seatgeek.com/new-york-mets-tickets/ that is 'new-york-mets'. **Outputs** - `category` (text): The top-level category they are filed under - `division_names` (list): The same, by name - `divisions` (list): League, conference and division membership, for a team - `genre_names` (list): Their genres, by name - `genres` (list): The performer's music genres - `has_upcoming_events` (true/false): Whether the performer has anything coming up - `id` (number): SeatGeek's ID for the performer - `image` (text): The best available picture - `image_huge` (text): Largest picture - `image_large` (text): Large picture - `image_medium` (text): Medium picture - `image_small` (text): Small picture - `lastfm_url` (text): Their Last.fm page - `links` (list): The performer's profiles on other services - `name` (text): Performer name - `num_upcoming_events` (number): How many events they have coming up, when published - `primary_genre` (text): Their main genre - `score` (number): SeatGeek's popularity ranking - `short_name` (text): A shorter form of the name - `slug` (text): The performer's slug on seatgeek.com - `spotify_url` (text): Their Spotify artist page - `taxonomies` (list): The categories they are filed under, in full - `taxonomy_names` (list): Every category slug they are filed under - `type` (text): What kind of act this is (band, nba_team, theater_production…) - `url` (text): The performer's page on seatgeek.com **Example output** ```json { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" } ``` ### Get performer details Read one artist, team or show in full: how SeatGeek classifies them, their artwork at four sizes, their music genres, their league and division for a team, their Spotify and Last.fm profiles, and whether they have anything coming up. **Inputs** - Performer ID (`performer_id`, number, required): The performer, by their SeatGeek ID. Performer IDs come from Search performers. At least 1. **Outputs** - `category` (text): The top-level category they are filed under - `division_names` (list): The same, by name - `divisions` (list): League, conference and division membership, for a team - `genre_names` (list): Their genres, by name - `genres` (list): The performer's music genres - `has_upcoming_events` (true/false): Whether the performer has anything coming up - `id` (number): SeatGeek's ID for the performer - `image` (text): The best available picture - `image_huge` (text): Largest picture - `image_large` (text): Large picture - `image_medium` (text): Medium picture - `image_small` (text): Small picture - `lastfm_url` (text): Their Last.fm page - `links` (list): The performer's profiles on other services - `name` (text): Performer name - `num_upcoming_events` (number): How many events they have coming up, when published - `primary_genre` (text): Their main genre - `score` (number): SeatGeek's popularity ranking - `short_name` (text): A shorter form of the name - `slug` (text): The performer's slug on seatgeek.com - `spotify_url` (text): Their Spotify artist page - `taxonomies` (list): The categories they are filed under, in full - `taxonomy_names` (list): Every category slug they are filed under - `type` (text): What kind of act this is (band, nba_team, theater_production…) - `url` (text): The performer's page on seatgeek.com **Example output** ```json { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" } ``` ### Get recommended events Ask SeatGeek what else someone would like: events similar to one or more performers, or to an event, near a place. Each result carries an affinity score, highest first. Location is required and does more than filter: a nearer event scores higher than an identical one further away, so this is the action behind 'you like these bands, here is what is on near you'. **Inputs** - Similar to these performers (`performer_ids`, list): The performers to base the recommendation on. Add more than one to blend their audiences: 'people who like these' rather than 'people who like each of these'. Give this, or a seed event below, or both. - Similar to this event (`event_id`, number): An event to base the recommendation on. Give this, or one or more seed performers above, or both. At least 1. - Near postcode (`postal_code`, text): Where the person is. Recommendations need a location: it decides which events are reachable and also ranks them, so a nearer event scores higher than an identical one further away. Give this, or a latitude and longitude below. - Latitude (`latitude`, number): Optional. Search around this point instead of a postcode. Give the longitude too. From -90 to 90. - Longitude (`longitude`, number): Optional. The longitude to go with the latitude above. From -180 to 180. - Within (`search_range`, number): How far from that point to look, in the unit chosen below. Recommendations default to 200, which is wider than a plain search because a recommendation is worth travelling for. From 1 to 25000. Default: `200`. - Distance unit (`range_unit`, text): Whether the distance above is in miles or kilometres. One of: `mi` (Miles), `km` (Kilometres). Default: `mi`. - Category (`taxonomy_id`, text): Optional. Only include events in this category: sport, concerts, theatre and so on. The list is read from SeatGeek, so it is always the current one. - Subcategory (`subtaxonomy_id`, text): Optional. Narrow the category further: NBA inside sport, or music festivals inside concerts. Choose a category first; this list is the subcategories inside it. When set, this wins over the category above. - Venue IDs (`venue_ids`, list): Optional. Only include events at these venues. Add more than one to cover several. Venue IDs come from Search venues. - Starting after (`start_after`, date and time): Optional. Only include events starting at or after this moment. Pick a date and time; it is sent to SeatGeek in UTC. - Starting before (`start_before`, date and time): Optional. Only include events starting at or before this moment. Pair it with 'Starting after' to search one window. - How many to return (`per_page`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`. - Page (`page`, number): Which page of results to return. The first page is 1. The answer says how many pages there are, so a loop can ask for the next one. From 1 to 100000. Default: `1`. **Outputs** - `events` (list): The recommended events, best match first - `geolocated_latitude` (number): The latitude SeatGeek resolved the location to - `geolocated_longitude` (number): The longitude SeatGeek resolved the location to - `geolocated_range` (text): The range SeatGeek applied - `has_more` (true/false): Whether there is another page after this one - `page` (number): Which page this is - `per_page` (number): The page size that was used - `returned_count` (number): How many results came back on this page - `searched_latitude` (number): The latitude searched around - `searched_longitude` (number): The longitude searched around - `searched_postal_code` (text): The postcode searched around - `searched_range` (text): The distance searched, with its unit (e.g. 25mi) - `searched_range_unit` (text): That distance's unit - `searched_range_value` (number): That distance as a number - `seed_event_id` (number): The event the recommendation was based on - `seed_performer_ids` (list): The performers the recommendation was based on - `start_after` (text): The earliest start time that was allowed, in UTC - `start_before` (text): The latest start time that was allowed, in UTC - `taxonomy_id` (text): The category ID the search was filtered on - `taxonomy_level` (text): Whether that ID was the category or the subcategory - `total_count` (number): How many results match in total, across every page - `total_pages` (number): How many pages there are **Example output** ```json { "events": [ { "affinity_score": 0.42, "announce_date": "2026-04-12T00:00:00", "average_price": 97, "away_team": null, "category": "Concert", "date_local": "2026-09-09", "date_tbd": false, "datetime_local": "2026-09-09T19:00:00", "datetime_utc": "2026-09-09T23:00:00", "has_tickets": true, "highest_price": 296, "home_team": null, "id": 721901, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "listing_count": 161, "lowest_price": 62, "median_price": 88, "performer_names": [ "Young the Giant", "Grouplove" ], "performers": [ { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "role": "primary", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" }, { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" } ], "has_upcoming_events": true, "id": 8987, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Grouplove", "num_upcoming_events": 14, "primary_genre": "Alternative", "role": "performer", "score": 0.54, "short_name": "Grouplove", "slug": "grouplove", "spotify_url": null, "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/grouplove-tickets" } ], "primary_performer": "Young the Giant", "score": 0.66, "short_title": "Young the Giant", "starts_display": "2026-09-09 19:00", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null }, { "display_name": "Music Festival", "id": 2010000, "name": "music_festival", "parent_id": 2000000 } ], "taxonomy_names": [ "concert", "music_festival" ], "time_local": "19:00", "time_tbd": false, "title": "Young the Giant with Grouplove", "type": "concert", "url": "https://seatgeek.com/young-the-giant-with-grouplove-tickets/new-york-new-york-terminal-5-2026-09-09/concert/721901", "venue": { "address": "610 W 56th St", "capacity": 3000, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 814, "latitude": 40.77167, "longitude": -73.99277, "name": "Terminal 5", "num_upcoming_events": 48, "postal_code": "10019", "score": 0.62, "slug": "terminal-5", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/terminal-5/tickets" }, "venue_address": "610 W 56th St", "venue_city": "New York", "venue_country": "US", "venue_id": 814, "venue_latitude": 40.77167, "venue_location": "New York, NY", "venue_longitude": -73.99277, "venue_name": "Terminal 5", "venue_postal_code": "10019", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/terminal-5/tickets", "visible_until": "2026-09-10T05:00:00" }, { "affinity_score": 0.11, "announce_date": "2026-08-15T00:00:00", "average_price": 212, "away_team": "Brooklyn Nets", "category": "Sports", "date_local": "2026-11-14", "date_tbd": false, "datetime_local": "2026-11-14T19:30:00", "datetime_utc": "2026-11-15T00:30:00", "has_tickets": true, "highest_price": 3500, "home_team": "New York Knicks", "id": 6154772, "image": "https://seatgeek.com/images/performers-landscape/new-york-knicks.jpg", "listing_count": 940, "lowest_price": 48, "median_price": null, "performer_names": [ "New York Knicks", "Brooklyn Nets" ], "performers": [ { "category": "Sports", "division_names": [ "Eastern Conference", "Atlantic Division" ], "divisions": [ { "id": 1, "name": "Eastern Conference", "slug": "eastern-conference", "type": "conference" }, { "id": 2, "name": "Atlantic Division", "slug": "atlantic-division", "type": "division" } ], "genre_names": [], "genres": [], "has_upcoming_events": true, "id": 2090, "image": "https://seatgeek.com/images/performers-landscape/new-york-knicks.jpg", "image_huge": "https://seatgeek.com/images/performers/2090/huge.jpg", "image_large": "https://seatgeek.com/images/performers/2090/large.jpg", "image_medium": "https://seatgeek.com/images/performers/2090/medium.jpg", "image_small": "https://seatgeek.com/images/performers/2090/small.jpg", "lastfm_url": null, "links": [], "name": "New York Knicks", "num_upcoming_events": 41, "primary_genre": null, "role": "home_team", "score": 0.88, "short_name": "Knicks", "slug": "new-york-knicks", "spotify_url": null, "taxonomies": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null }, { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "sports", "nba" ], "type": "nba_team", "url": "https://seatgeek.com/new-york-knicks-tickets" }, { "category": null, "division_names": [], "divisions": [], "genre_names": [], "genres": [], "has_upcoming_events": null, "id": 2091, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Brooklyn Nets", "num_upcoming_events": null, "primary_genre": null, "role": "away_team", "score": 0.74, "short_name": null, "slug": "brooklyn-nets", "spotify_url": null, "taxonomies": [ { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "nba" ], "type": "nba_team", "url": null } ], "primary_performer": "New York Knicks", "score": 0.81, "short_title": "Knicks at Nets", "starts_display": "2026-11-14 19:30", "taxonomies": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null }, { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "sports", "nba" ], "time_local": "19:30", "time_tbd": false, "title": "New York Knicks at Brooklyn Nets", "type": "nba", "url": "https://seatgeek.com/new-york-knicks-at-brooklyn-nets-tickets/6154772", "venue": { "address": "4 Pennsylvania Plaza", "capacity": null, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 3120, "latitude": 40.7505, "longitude": -73.9934, "name": "Madison Square Garden", "num_upcoming_events": 213, "postal_code": "10001", "score": 0.99, "slug": "madison-square-garden", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/madison-square-garden/tickets" }, "venue_address": "4 Pennsylvania Plaza", "venue_city": "New York", "venue_country": "US", "venue_id": 3120, "venue_latitude": 40.7505, "venue_location": "New York, NY", "venue_longitude": -73.9934, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/madison-square-garden/tickets", "visible_until": null } ], "geolocated_latitude": 40.7359, "geolocated_longitude": -74.0036, "geolocated_range": "200mi", "has_more": false, "page": 1, "per_page": 10, "returned_count": 2, "searched_postal_code": "10014", "searched_range": "200mi", "searched_range_unit": "mi", "searched_range_value": 200, "seed_performer_ids": [ 8741 ], "total_count": 2, "total_pages": 1 } ``` ### Get recommended performers Ask SeatGeek which other acts someone would like, given one or more performers or an event, with an affinity score on each. A performer used as the seed is left out of the answer; the performers on a seed event are not. This is the 'if you like this band' list, and the IDs it returns feed straight into Get events for a performer. **Inputs** - Similar to these performers (`performer_ids`, list): The performers to base the recommendation on. Add more than one to blend their audiences: 'people who like these' rather than 'people who like each of these'. Give this, or a seed event below, or both. - Similar to this event (`event_id`, number): An event to base the recommendation on. Give this, or one or more seed performers above, or both. At least 1. - How many to return (`per_page`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`. - Page (`page`, number): Which page of results to return. The first page is 1. The answer says how many pages there are, so a loop can ask for the next one. From 1 to 100000. Default: `1`. **Outputs** - `has_more` (true/false): Whether there is another page after this one - `page` (number): Which page this is - `per_page` (number): The page size that was used - `performers` (list): The recommended performers, best match first - `returned_count` (number): How many results came back on this page - `seed_event_id` (number): The event the recommendation was based on - `seed_performer_ids` (list): The performers the recommendation was based on - `total_count` (number): How many results match in total, across every page - `total_pages` (number): How many pages there are **Example output** ```json { "has_more": false, "page": 1, "per_page": 10, "performers": [ { "affinity_score": 3.05, "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" }, { "affinity_score": 1.2, "category": "Sports", "division_names": [ "Eastern Conference", "Atlantic Division" ], "divisions": [ { "id": 1, "name": "Eastern Conference", "slug": "eastern-conference", "type": "conference" }, { "id": 2, "name": "Atlantic Division", "slug": "atlantic-division", "type": "division" } ], "genre_names": [], "genres": [], "has_upcoming_events": true, "id": 2090, "image": "https://seatgeek.com/images/performers-landscape/new-york-knicks.jpg", "image_huge": "https://seatgeek.com/images/performers/2090/huge.jpg", "image_large": "https://seatgeek.com/images/performers/2090/large.jpg", "image_medium": "https://seatgeek.com/images/performers/2090/medium.jpg", "image_small": "https://seatgeek.com/images/performers/2090/small.jpg", "lastfm_url": null, "links": [], "name": "New York Knicks", "num_upcoming_events": 41, "primary_genre": null, "score": 0.88, "short_name": "Knicks", "slug": "new-york-knicks", "spotify_url": null, "taxonomies": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null }, { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "sports", "nba" ], "type": "nba_team", "url": "https://seatgeek.com/new-york-knicks-tickets" } ], "returned_count": 2, "seed_performer_ids": [ 8741 ], "total_count": 2, "total_pages": 1 } ``` ### Get venue details Read one venue in full: its street address, its city, state and postcode, its latitude and longitude, its timezone and capacity where SeatGeek publishes them, and its page on seatgeek.com. **Inputs** - Venue ID (`venue_id`, number, required): The venue, by its SeatGeek ID. Venue IDs come from Search venues, and from the 'venue_id' field on any event. At least 1. **Outputs** - `address` (text): Street address - `capacity` (number): Seating capacity, when published - `city` (text): City - `country` (text): Two-letter country code - `display_location` (text): City and state as one line, ready to print - `extended_address` (text): The second line of the address, when there is one - `has_upcoming_events` (true/false): Whether the venue has anything coming up - `id` (number): SeatGeek's ID for the venue - `latitude` (number): Latitude in degrees - `longitude` (number): Longitude in degrees - `name` (text): Venue name - `num_upcoming_events` (number): How many events are coming up there, when published - `postal_code` (text): Postcode - `score` (number): SeatGeek's popularity ranking - `slug` (text): The venue's slug on seatgeek.com - `state` (text): State or province code - `timezone` (text): The venue's timezone, when published - `url` (text): The venue's page on seatgeek.com **Example output** ```json { "address": "610 W 56th St", "capacity": 3000, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 814, "latitude": 40.77167, "longitude": -73.99277, "name": "Terminal 5", "num_upcoming_events": 48, "postal_code": "10019", "score": 0.62, "slug": "terminal-5", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/terminal-5/tickets" } ``` ### List categories Read the category tree every event and performer is filed under: the top-level categories (sport, concerts, theatre) and the subcategories inside each one (NBA, music festivals). This is where the category IDs the search filters take come from, and the tree comes back assembled rather than as the flat list the API sends. **Inputs**: None. **Outputs** - `categories` (list): The top-level categories, each with its subcategories - `category_count` (number): How many of them are top-level - `category_names` (list): The top-level categories, by slug - `taxonomies` (list): Every category, flat, at every level - `total_count` (number): How many categories there are in total **Example output** ```json { "categories": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null, "subcategories": [ { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000, "subcategories": [] }, { "display_name": "Monster Truck", "id": 1060400, "name": "monster_truck", "parent_id": 1000000, "subcategories": [] } ] }, { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null, "subcategories": [ { "display_name": "Music Festival", "id": 2010000, "name": "music_festival", "parent_id": 2000000, "subcategories": [] } ] }, { "display_name": "Theater", "id": 3000000, "name": "theater", "parent_id": null, "subcategories": [] } ], "category_count": 3, "category_names": [ "sports", "concert", "theater" ], "taxonomies": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null }, { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 }, { "display_name": "Monster Truck", "id": 1060400, "name": "monster_truck", "parent_id": 1000000 }, { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null }, { "display_name": "Music Festival", "id": 2010000, "name": "music_festival", "parent_id": 2000000 }, { "display_name": "Theater", "id": 3000000, "name": "theater", "parent_id": null } ], "total_count": 6 } ``` ### Search events Search SeatGeek's event catalogue (concerts, sport, theatre, comedy and festivals across the United States and Canada) with the filters a search actually uses. Words, where (city, state, country, postcode, or a distance around a point), what (category and subcategory), who (performer or venue), when, and what the tickets cost. Each event comes back flattened, with its venue, its start time, its cheapest ticket and the link to buy. **Inputs** - Search for (`query`, text): Optional. Words to search on: an artist, a team, a show, a venue or a city. This searches everything about an event at once, so 'madison' finds Madison Square Garden and events in Madison, WI. Leave it empty to browse by the filters below alone. - City (`venue_city`, text): Optional. Only include events at venues in this city. - State or province (`venue_state`, text): Optional. Only include events in this US state or Canadian province. One of: `AL` (Alabama (US)), `AK` (Alaska (US)), `AB` (Alberta (Canada)), `AS` (American Samoa (US)), `AZ` (Arizona (US)), `AR` (Arkansas (US)), `BC` (British Columbia (Canada)), `CA` (California (US)), `CO` (Colorado (US)), `CT` (Connecticut (US)), and 59 more. - Country (`venue_country`, text): Optional. Only include events in this country. SeatGeek's catalogue is deepest in the United States and Canada. One of: `US` (United States), `CA` (Canada), `GB` (United Kingdom), `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), and 239 more. - Venue postcode (`venue_postal_code`, text): Optional. Only include events at venues with exactly this postcode. To search an area around a postcode instead, use 'Near postcode'. - Near postcode (`near_postal_code`, text): Optional. Search around this US or Canadian postcode rather than at exactly it, out to the distance below. - Latitude (`latitude`, number): Optional. Search around this point instead of a postcode. Give the longitude too. From -90 to 90. - Longitude (`longitude`, number): Optional. The longitude to go with the latitude above. From -180 to 180. - Within (`search_range`, number): How far from that point to search, in the unit chosen below. Defaults to 30. From 1 to 25000. Default: `30`. - Distance unit (`range_unit`, text): Whether the distance above is in miles or kilometres. One of: `mi` (Miles), `km` (Kilometres). Default: `mi`. - Category (`taxonomy_id`, text): Optional. Only include events in this category: sport, concerts, theatre and so on. The list is read from SeatGeek, so it is always the current one. - Subcategory (`subtaxonomy_id`, text): Optional. Narrow the category further: NBA inside sport, or music festivals inside concerts. Choose a category first; this list is the subcategories inside it. When set, this wins over the category above. - Performer IDs (`performer_ids`, list): Optional. Only include events featuring these performers. Add more than one to match any of them. Performer IDs come from Search performers. - Performer slug (`performer_slug`, text): Optional. Only include events featuring this performer, named by the slug in their seatgeek.com address: the part after the domain and before '-tickets'. - Playing as (`performer_role`, text): Which role the performer has to have at the event. 'As the headliner' skips the dates where they are the support act; the two team roles split a fixture into home games and away games. One of: `any` (In any role), `primary` (As the headliner), `home_team` (As the home team), `away_team` (As the away team). Default: `any`. - Venue IDs (`venue_ids`, list): Optional. Only include events at these venues. Add more than one to cover several. Venue IDs come from Search venues. - Starting after (`start_after`, date and time): Optional. Only include events starting at or after this moment. Pick a date and time; it is sent to SeatGeek in UTC. - Starting before (`start_before`, date and time): Optional. Only include events starting at or before this moment. Pair it with 'Starting after' to search one window. - Only events with tickets on sale (`only_with_tickets`, true/false): Skip events that currently have no ticket listings. SeatGeek lists events before any seller has posted tickets, so this is what keeps a 'go and buy' message from linking to an empty page. Default: `false`. - At least this many listings (`min_listing_count`, number): Optional. Only include events with at least this many ticket listings, a rough measure of how much choice there is. Setting this replaces the switch above. From 0 to 1000000. - Cheapest ticket at most (`max_lowest_price`, number): Optional. Only include events where the cheapest ticket costs this or less, in US dollars. This is the filter behind 'anything under $50'. From 0 to 1000000. - Average ticket at most (`max_average_price`, number): Optional. Only include events whose average listing price is this or less, in US dollars. From 0 to 1000000. - Dearest ticket at most (`max_highest_price`, number): Optional. Only include events whose most expensive listing is this or less, in US dollars, which rules out the events with a premium tier. From 0 to 1000000. - Order by (`sort`, text): What order to return the events in. One of: `datetime_utc.asc` (Soonest first), `datetime_utc.desc` (Furthest ahead first), `datetime_local.asc` (Soonest first, by the venue's local clock), `datetime_local.desc` (Furthest ahead first, by the venue's local clock), `announce_date.desc` (Most recently announced first), `announce_date.asc` (Longest announced first), `score.desc` (Most popular first), `score.asc` (Least popular first), `id.asc` (Lowest event ID first), `id.desc` (Highest event ID first). Default: `datetime_utc.asc`. - How many to return (`per_page`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`. - Page (`page`, number): Which page of results to return. The first page is 1. The answer says how many pages there are, so a loop can ask for the next one. From 1 to 100000. Default: `1`. **Outputs** - `events` (list): The events that matched - `geolocated_latitude` (number): The latitude SeatGeek resolved the location to - `geolocated_longitude` (number): The longitude SeatGeek resolved the location to - `geolocated_range` (text): The range SeatGeek applied - `has_more` (true/false): Whether there is another page after this one - `page` (number): Which page this is - `per_page` (number): The page size that was used - `performer_slug` (text): The performer slug that was filtered on - `query` (text): The words that were searched for - `returned_count` (number): How many results came back on this page - `searched_latitude` (number): The latitude searched around - `searched_longitude` (number): The longitude searched around - `searched_postal_code` (text): The postcode searched around - `searched_range` (text): The distance searched, with its unit (e.g. 25mi) - `searched_range_unit` (text): That distance's unit - `searched_range_value` (number): That distance as a number - `sort` (text): The ordering that was applied - `sort_label` (text): That ordering, written out - `start_after` (text): The earliest start time that was allowed, in UTC - `start_before` (text): The latest start time that was allowed, in UTC - `taxonomy_id` (text): The category ID the search was filtered on - `taxonomy_level` (text): Whether that ID was the category or the subcategory - `total_count` (number): How many results match in total, across every page - `total_pages` (number): How many pages there are - `venue_city` (text): The city that was filtered on - `venue_country` (text): The country that was filtered on - `venue_postal_code` (text): The venue postcode that was filtered on - `venue_state` (text): The state that was filtered on **Example output** ```json { "events": [ { "announce_date": "2026-04-12T00:00:00", "average_price": 97, "away_team": null, "category": "Concert", "date_local": "2026-09-09", "date_tbd": false, "datetime_local": "2026-09-09T19:00:00", "datetime_utc": "2026-09-09T23:00:00", "has_tickets": true, "highest_price": 296, "home_team": null, "id": 721901, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "listing_count": 161, "lowest_price": 62, "median_price": 88, "performer_names": [ "Young the Giant", "Grouplove" ], "performers": [ { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "role": "primary", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" }, { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" } ], "has_upcoming_events": true, "id": 8987, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Grouplove", "num_upcoming_events": 14, "primary_genre": "Alternative", "role": "performer", "score": 0.54, "short_name": "Grouplove", "slug": "grouplove", "spotify_url": null, "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/grouplove-tickets" } ], "primary_performer": "Young the Giant", "score": 0.66, "short_title": "Young the Giant", "starts_display": "2026-09-09 19:00", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null }, { "display_name": "Music Festival", "id": 2010000, "name": "music_festival", "parent_id": 2000000 } ], "taxonomy_names": [ "concert", "music_festival" ], "time_local": "19:00", "time_tbd": false, "title": "Young the Giant with Grouplove", "type": "concert", "url": "https://seatgeek.com/young-the-giant-with-grouplove-tickets/new-york-new-york-terminal-5-2026-09-09/concert/721901", "venue": { "address": "610 W 56th St", "capacity": 3000, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 814, "latitude": 40.77167, "longitude": -73.99277, "name": "Terminal 5", "num_upcoming_events": 48, "postal_code": "10019", "score": 0.62, "slug": "terminal-5", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/terminal-5/tickets" }, "venue_address": "610 W 56th St", "venue_city": "New York", "venue_country": "US", "venue_id": 814, "venue_latitude": 40.77167, "venue_location": "New York, NY", "venue_longitude": -73.99277, "venue_name": "Terminal 5", "venue_postal_code": "10019", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/terminal-5/tickets", "visible_until": "2026-09-10T05:00:00" }, { "announce_date": "2026-08-15T00:00:00", "average_price": 212, "away_team": "Brooklyn Nets", "category": "Sports", "date_local": "2026-11-14", "date_tbd": false, "datetime_local": "2026-11-14T19:30:00", "datetime_utc": "2026-11-15T00:30:00", "has_tickets": true, "highest_price": 3500, "home_team": "New York Knicks", "id": 6154772, "image": "https://seatgeek.com/images/performers-landscape/new-york-knicks.jpg", "listing_count": 940, "lowest_price": 48, "median_price": null, "performer_names": [ "New York Knicks", "Brooklyn Nets" ], "performers": [ { "category": "Sports", "division_names": [ "Eastern Conference", "Atlantic Division" ], "divisions": [ { "id": 1, "name": "Eastern Conference", "slug": "eastern-conference", "type": "conference" }, { "id": 2, "name": "Atlantic Division", "slug": "atlantic-division", "type": "division" } ], "genre_names": [], "genres": [], "has_upcoming_events": true, "id": 2090, "image": "https://seatgeek.com/images/performers-landscape/new-york-knicks.jpg", "image_huge": "https://seatgeek.com/images/performers/2090/huge.jpg", "image_large": "https://seatgeek.com/images/performers/2090/large.jpg", "image_medium": "https://seatgeek.com/images/performers/2090/medium.jpg", "image_small": "https://seatgeek.com/images/performers/2090/small.jpg", "lastfm_url": null, "links": [], "name": "New York Knicks", "num_upcoming_events": 41, "primary_genre": null, "role": "home_team", "score": 0.88, "short_name": "Knicks", "slug": "new-york-knicks", "spotify_url": null, "taxonomies": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null }, { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "sports", "nba" ], "type": "nba_team", "url": "https://seatgeek.com/new-york-knicks-tickets" }, { "category": null, "division_names": [], "divisions": [], "genre_names": [], "genres": [], "has_upcoming_events": null, "id": 2091, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Brooklyn Nets", "num_upcoming_events": null, "primary_genre": null, "role": "away_team", "score": 0.74, "short_name": null, "slug": "brooklyn-nets", "spotify_url": null, "taxonomies": [ { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "nba" ], "type": "nba_team", "url": null } ], "primary_performer": "New York Knicks", "score": 0.81, "short_title": "Knicks at Nets", "starts_display": "2026-11-14 19:30", "taxonomies": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null }, { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "sports", "nba" ], "time_local": "19:30", "time_tbd": false, "title": "New York Knicks at Brooklyn Nets", "type": "nba", "url": "https://seatgeek.com/new-york-knicks-at-brooklyn-nets-tickets/6154772", "venue": { "address": "4 Pennsylvania Plaza", "capacity": null, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 3120, "latitude": 40.7505, "longitude": -73.9934, "name": "Madison Square Garden", "num_upcoming_events": 213, "postal_code": "10001", "score": 0.99, "slug": "madison-square-garden", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/madison-square-garden/tickets" }, "venue_address": "4 Pennsylvania Plaza", "venue_city": "New York", "venue_country": "US", "venue_id": 3120, "venue_latitude": 40.7505, "venue_location": "New York, NY", "venue_longitude": -73.9934, "venue_name": "Madison Square Garden", "venue_postal_code": "10001", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/madison-square-garden/tickets", "visible_until": null } ], "has_more": false, "page": 1, "per_page": 10, "query": "young the giant", "returned_count": 2, "sort": "datetime_utc.asc", "sort_label": "Soonest first", "start_after": "2026-09-01T00:00:00", "start_before": "2026-12-01T00:00:00", "taxonomy_id": "2000000", "taxonomy_level": "category", "total_count": 2, "total_pages": 1, "venue_city": "New York", "venue_country": "US", "venue_state": "NY" } ``` ### Search performers Find an artist, band, team or show by name. This is how a workflow turns a name someone typed into the performer ID the event actions take, and each result carries the act's category, genres, artwork, Spotify and Last.fm profiles and how many dates they have coming up. **Inputs** - Search for (`query`, text): Optional. The name to search for: an artist, a band, a team or a show. This is how a name someone typed becomes the performer ID the event actions take. Leave it empty to browse by the filters below alone. - Category (`taxonomy_id`, text): Optional. Only include events in this category: sport, concerts, theatre and so on. The list is read from SeatGeek, so it is always the current one. - Subcategory (`subtaxonomy_id`, text): Optional. Narrow the category further: NBA inside sport, or music festivals inside concerts. Choose a category first; this list is the subcategories inside it. When set, this wins over the category above. - Music genre (`genre_slug`, text): Optional. Only include music performers in this genre, by its slug. A performer's genres are on their record, so Search performers or Get performer details is where to read the spelling of one. - Only if it is their main genre (`primary_genre_only`, true/false): Match only performers whose main genre is the one above, rather than any performer it is also filed under. Off matches a rock band that also counts as pop; on does not. Default: `false`. - Order by (`sort`, text): What order to return the results in. Popularity is SeatGeek's own ranking, based on ticket sales. One of: `score.desc` (Most popular first), `score.asc` (Least popular first), `id.asc` (Lowest ID first), `id.desc` (Highest ID first). Default: `score.desc`. - How many to return (`per_page`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`. - Page (`page`, number): Which page of results to return. The first page is 1. The answer says how many pages there are, so a loop can ask for the next one. From 1 to 100000. Default: `1`. **Outputs** - `genre_slug` (text): The genre that was filtered on - `has_more` (true/false): Whether there is another page after this one - `page` (number): Which page this is - `per_page` (number): The page size that was used - `performers` (list): The performers that matched - `primary_genre_only` (true/false): Whether that genre had to be the performer's main one - `query` (text): The words that were searched for - `returned_count` (number): How many results came back on this page - `sort` (text): The ordering that was applied - `sort_label` (text): That ordering, written out - `taxonomy_id` (text): The category ID the search was filtered on - `taxonomy_level` (text): Whether that ID was the category or the subcategory - `total_count` (number): How many results match in total, across every page - `total_pages` (number): How many pages there are **Example output** ```json { "has_more": false, "page": 1, "per_page": 10, "performers": [ { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" }, { "category": "Sports", "division_names": [ "Eastern Conference", "Atlantic Division" ], "divisions": [ { "id": 1, "name": "Eastern Conference", "slug": "eastern-conference", "type": "conference" }, { "id": 2, "name": "Atlantic Division", "slug": "atlantic-division", "type": "division" } ], "genre_names": [], "genres": [], "has_upcoming_events": true, "id": 2090, "image": "https://seatgeek.com/images/performers-landscape/new-york-knicks.jpg", "image_huge": "https://seatgeek.com/images/performers/2090/huge.jpg", "image_large": "https://seatgeek.com/images/performers/2090/large.jpg", "image_medium": "https://seatgeek.com/images/performers/2090/medium.jpg", "image_small": "https://seatgeek.com/images/performers/2090/small.jpg", "lastfm_url": null, "links": [], "name": "New York Knicks", "num_upcoming_events": 41, "primary_genre": null, "score": 0.88, "short_name": "Knicks", "slug": "new-york-knicks", "spotify_url": null, "taxonomies": [ { "display_name": "Sports", "id": 1000000, "name": "sports", "parent_id": null }, { "display_name": "NBA", "id": 1010000, "name": "nba", "parent_id": 1000000 } ], "taxonomy_names": [ "sports", "nba" ], "type": "nba_team", "url": "https://seatgeek.com/new-york-knicks-tickets" } ], "query": "young the giant", "returned_count": 2, "sort": "score.desc", "sort_label": "Most popular first", "total_count": 2, "total_pages": 1 } ``` ### 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** - Starting within (`window`, text): How far ahead to look, counted from the moment this step runs. Because it moves with the clock, a scheduled workflow keeps finding what is coming up instead of going empty. One of: `24_hours` (The next 24 hours), `3_days` (The next 3 days), `7_days` (The next 7 days), `14_days` (The next 14 days), `30_days` (The next 30 days), `90_days` (The next 90 days). Default: `7_days`. - Search for (`query`, text): Optional. Words to search on: an artist, a team, a show, a venue or a city. This searches everything about an event at once, so 'madison' finds Madison Square Garden and events in Madison, WI. Leave it empty to browse by the filters below alone. - City (`venue_city`, text): Optional. Only include events at venues in this city. - State or province (`venue_state`, text): Optional. Only include events in this US state or Canadian province. One of: `AL` (Alabama (US)), `AK` (Alaska (US)), `AB` (Alberta (Canada)), `AS` (American Samoa (US)), `AZ` (Arizona (US)), `AR` (Arkansas (US)), `BC` (British Columbia (Canada)), `CA` (California (US)), `CO` (Colorado (US)), `CT` (Connecticut (US)), and 59 more. - Country (`venue_country`, text): Optional. Only include events in this country. SeatGeek's catalogue is deepest in the United States and Canada. One of: `US` (United States), `CA` (Canada), `GB` (United Kingdom), `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), and 239 more. - Category (`taxonomy_id`, text): Optional. Only include events in this category: sport, concerts, theatre and so on. The list is read from SeatGeek, so it is always the current one. - Subcategory (`subtaxonomy_id`, text): Optional. Narrow the category further: NBA inside sport, or music festivals inside concerts. Choose a category first; this list is the subcategories inside it. When set, this wins over the category above. - Performer slug (`performer_slug`, text): Optional. Only include events featuring this performer, named by the slug in their seatgeek.com address: the part after the domain and before '-tickets'. - Only events with tickets on sale (`only_with_tickets`, true/false): Skip events that currently have no ticket listings. SeatGeek lists events before any seller has posted tickets, so this is what keeps a 'go and buy' message from linking to an empty page. Default: `false`. - Order by (`sort`, text): What order to return the events in. One of: `datetime_utc.asc` (Soonest first), `datetime_utc.desc` (Furthest ahead first), `datetime_local.asc` (Soonest first, by the venue's local clock), `datetime_local.desc` (Furthest ahead first, by the venue's local clock), `announce_date.desc` (Most recently announced first), `announce_date.asc` (Longest announced first), `score.desc` (Most popular first), `score.asc` (Least popular first), `id.asc` (Lowest event ID first), `id.desc` (Highest event ID first). Default: `datetime_utc.asc`. - How many to return (`per_page`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`. **Outputs** - `events` (list): The events that matched - `has_more` (true/false): Whether there is another page after this one - `page` (number): Which page this is - `per_page` (number): The page size that was used - `query` (text): The words that were searched for - `returned_count` (number): How many results came back on this page - `sort` (text): The ordering that was applied - `sort_label` (text): That ordering, written out - `start_after` (text): The earliest start time that was allowed, in UTC - `start_before` (text): The latest start time that was allowed, in UTC - `taxonomy_id` (text): The category ID the search was filtered on - `taxonomy_level` (text): Whether that ID was the category or the subcategory - `total_count` (number): How many results match in total, across every page - `total_pages` (number): How many pages there are - `venue_city` (text): The city that was filtered on - `venue_country` (text): The country that was filtered on - `venue_postal_code` (text): The venue postcode that was filtered on - `venue_state` (text): The state that was filtered on - `window` (text): The window that was asked for - `window_label` (text): That window, written out **Example output** ```json { "events": [ { "announce_date": "2026-04-12T00:00:00", "average_price": 97, "away_team": null, "category": "Concert", "date_local": "2026-09-09", "date_tbd": false, "datetime_local": "2026-09-09T19:00:00", "datetime_utc": "2026-09-09T23:00:00", "has_tickets": true, "highest_price": 296, "home_team": null, "id": 721901, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "listing_count": 161, "lowest_price": 62, "median_price": 88, "performer_names": [ "Young the Giant", "Grouplove" ], "performers": [ { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative", "Rock" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" }, { "id": 31, "name": "Rock", "primary": false, "slug": "rock" } ], "has_upcoming_events": true, "id": 8741, "image": "https://seatgeek.com/images/performers-landscape/young-the-giant.jpg", "image_huge": "https://seatgeek.com/images/performers/8741/huge.jpg", "image_large": "https://seatgeek.com/images/performers/8741/large.jpg", "image_medium": "https://seatgeek.com/images/performers/8741/medium.jpg", "image_small": "https://seatgeek.com/images/performers/8741/small.jpg", "lastfm_url": "https://www.last.fm/music/Young+the+Giant", "links": [ { "id": "spotify:artist:1zHFIBQ4Ilqm9J4kXsl2Xz", "provider": "spotify", "url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz" }, { "id": null, "provider": "lastfm", "url": "https://www.last.fm/music/Young+the+Giant" } ], "name": "Young the Giant", "num_upcoming_events": 26, "primary_genre": "Alternative", "role": "primary", "score": 0.71, "short_name": "Young the Giant", "slug": "young-the-giant", "spotify_url": "https://open.spotify.com/artist/1zHFIBQ4Ilqm9J4kXsl2Xz", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/young-the-giant-tickets" }, { "category": "Concert", "division_names": [], "divisions": [], "genre_names": [ "Alternative" ], "genres": [ { "id": 27, "name": "Alternative", "primary": true, "slug": "alternative" } ], "has_upcoming_events": true, "id": 8987, "image": null, "image_huge": null, "image_large": null, "image_medium": null, "image_small": null, "lastfm_url": null, "links": [], "name": "Grouplove", "num_upcoming_events": 14, "primary_genre": "Alternative", "role": "performer", "score": 0.54, "short_name": "Grouplove", "slug": "grouplove", "spotify_url": null, "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null } ], "taxonomy_names": [ "concert" ], "type": "band", "url": "https://seatgeek.com/grouplove-tickets" } ], "primary_performer": "Young the Giant", "score": 0.66, "short_title": "Young the Giant", "starts_display": "2026-09-09 19:00", "taxonomies": [ { "display_name": "Concert", "id": 2000000, "name": "concert", "parent_id": null }, { "display_name": "Music Festival", "id": 2010000, "name": "music_festival", "parent_id": 2000000 } ], "taxonomy_names": [ "concert", "music_festival" ], "time_local": "19:00", "time_tbd": false, "title": "Young the Giant with Grouplove", "type": "concert", "url": "https://seatgeek.com/young-the-giant-with-grouplove-tickets/new-york-new-york-terminal-5-2026-09-09/concert/721901", "venue": { "address": "610 W 56th St", "capacity": 3000, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 814, "latitude": 40.77167, "longitude": -73.99277, "name": "Terminal 5", "num_upcoming_events": 48, "postal_code": "10019", "score": 0.62, "slug": "terminal-5", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/terminal-5/tickets" }, "venue_address": "610 W 56th St", "venue_city": "New York", "venue_country": "US", "venue_id": 814, "venue_latitude": 40.77167, "venue_location": "New York, NY", "venue_longitude": -73.99277, "venue_name": "Terminal 5", "venue_postal_code": "10019", "venue_state": "NY", "venue_url": "https://seatgeek.com/venues/terminal-5/tickets", "visible_until": "2026-09-10T05:00:00" } ], "has_more": false, "page": 1, "per_page": 10, "returned_count": 1, "sort": "datetime_utc.asc", "sort_label": "Soonest first", "start_after": "2026-08-26T12:00:00", "start_before": "2026-09-02T12:00:00", "total_count": 1, "total_pages": 1, "venue_city": "New York", "window": "7_days", "window_label": "The next 7 days" } ``` ### Search venues Find a venue by name, city, state, country or postcode. Every venue comes back with its street address, its coordinates, its timezone and its SeatGeek page, and with the venue ID that Get events at a venue takes. **Inputs** - Search for (`query`, text): Optional. Words to search venues on: part of a name, or a place. Leave it empty to browse by the filters below alone. - City (`city`, text): Optional. Only include venues in this city. - State or province (`state`, text): Optional. Only include venues in this US state or Canadian province. One of: `AL` (Alabama (US)), `AK` (Alaska (US)), `AB` (Alberta (Canada)), `AS` (American Samoa (US)), `AZ` (Arizona (US)), `AR` (Arkansas (US)), `BC` (British Columbia (Canada)), `CA` (California (US)), `CO` (Colorado (US)), `CT` (Connecticut (US)), and 59 more. - Country (`country`, text): Optional. Only include venues in this country. One of: `US` (United States), `CA` (Canada), `GB` (United Kingdom), `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), and 239 more. - Postcode (`postal_code`, text): Optional. Only include venues with this postcode. - Order by (`sort`, text): What order to return the results in. Popularity is SeatGeek's own ranking, based on ticket sales. One of: `score.desc` (Most popular first), `score.asc` (Least popular first), `id.asc` (Lowest ID first), `id.desc` (Highest ID first). Default: `score.desc`. - How many to return (`per_page`, number): How many results to return, from 1 to 100. Defaults to 10. From 1 to 100. Default: `10`. - Page (`page`, number): Which page of results to return. The first page is 1. The answer says how many pages there are, so a loop can ask for the next one. From 1 to 100000. Default: `1`. **Outputs** - `city` (text): The city that was filtered on - `country` (text): The country that was filtered on - `has_more` (true/false): Whether there is another page after this one - `page` (number): Which page this is - `per_page` (number): The page size that was used - `postal_code` (text): The postcode that was filtered on - `query` (text): The words that were searched for - `returned_count` (number): How many results came back on this page - `sort` (text): The ordering that was applied - `sort_label` (text): That ordering, written out - `state` (text): The state or province that was filtered on - `total_count` (number): How many results match in total, across every page - `total_pages` (number): How many pages there are - `venues` (list): The venues that matched **Example output** ```json { "city": "New York", "has_more": false, "page": 1, "per_page": 10, "query": "terminal", "returned_count": 2, "sort": "score.desc", "sort_label": "Most popular first", "state": "NY", "total_count": 2, "total_pages": 1, "venues": [ { "address": "610 W 56th St", "capacity": 3000, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 814, "latitude": 40.77167, "longitude": -73.99277, "name": "Terminal 5", "num_upcoming_events": 48, "postal_code": "10019", "score": 0.62, "slug": "terminal-5", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/terminal-5/tickets" }, { "address": "4 Pennsylvania Plaza", "capacity": null, "city": "New York", "country": "US", "display_location": "New York, NY", "extended_address": null, "has_upcoming_events": true, "id": 3120, "latitude": 40.7505, "longitude": -73.9934, "name": "Madison Square Garden", "num_upcoming_events": 213, "postal_code": "10001", "score": 0.99, "slug": "madison-square-garden", "state": "NY", "timezone": "America/New_York", "url": "https://seatgeek.com/venues/madison-square-garden/tickets" } ] } ```