Search StubHub Events Catalog
event-searchFull Description
Use this when the user wants to discover events, performances, games, matches, shows, etc. Use this tool to make high-intent searches for specific performer names, team names, event names, venue names, or other specific entities. Also use this tool to make low-intent searches for broad categories, generes, performance types, etc. This is the primary discovery tool and should be called BEFORE any other tools when the user doesn't have an event_id. High-intent example prompts: 'Find Taylor Swift concerts', 'Show me Yankees games in July near Boston', 'What Wicked shows are this weekend?', 'Lakers games in December in Los Angeles', 'Bad Bunny concerts next month', Low-intent example prompts: 'pop concerts this month in vegas', football games next week', 'broadway musicals coming up', 'standup comedy shows happening at the beacon theatre', 'college basketball games in madison square garden', etc. DO NOT use this tool if the useris asking about an event that already has an event_id from a previous call.
Parameters
querystringThe search term for finding events (performer name, team name, event name, venue). Examples: 'Taylor Swift', 'New York Yankees', 'Hamilton', 'Knicks vs. Lakers', 'Coachella', 'Madison Square Garden'.
category_tagsarrayList of relevant tags for this query. Can be multiple tags if the category spans multiple types. Analyze the query to determine the most relevant tags. Tags must be selected from the predefined enum of allowed values. Tags are formatted as 'TYPE_SUBTYPE' (e.g., SPORT_NBA, CONCERT_Metal, THEATER_Play) where TYPE is the high-level category and SUBTYPE is the specific genre, sport, or style. If high-level categories are requested without a subtype, i.e. 'show me upcoming CONCERTS', use the generic tag for that TYPE. generic tags for a TYPE are formatted as 'TYPE_' (omitting the SUBTYPE) Examples:MULTIPLE SPECIFIC TAGS (query matches several subcategories):- 'basketball las vegas' → ['SPORT_NBA', 'SPORT_WNBA', 'SPORT_College_Basketball']- 'football tickets' → ['SPORT_NFL', 'SPORT_College_Football']- 'rock concert' → ['CONCERT_Rock', 'CONCERT_HardRock', 'CONCERT_Metal', 'CONCERT_Alternative']SINGLE SPECIFIC TAG (confident about one subcategory):- 'knicks vs lakers' → ['SPORT_NBA']- 'taylor swift' → ['CONCERT_Pop']- 'hamilton broadway' → ['THEATER_Broadway']- 'nfl game' → ['SPORT_NFL']- 'stand up comedy' → ['THEATER_StandUp']- 'coachella festival' → ['FESTIVAL_Music']SINGLE PARTIAL TAG (category clear, subcategory unclear):- 'concert tonight' → ['CONCERT_']- 'sports game near me' → ['SPORT_']- 'theater show' → ['THEATER_']- 'live music' → ['CONCERT_']ALL CATEGORY PREFIXES (very general exploration):- 'what to do' → ['SPORT_', 'CONCERT_', 'THEATER_', 'FESTIVAL_']- 'stuff to do in new york' → ['SPORT_', 'CONCERT_', 'THEATER_', 'FESTIVAL_']- 'what's going on' → ['SPORT_', 'CONCERT_', 'THEATER_', 'FESTIVAL_']- 'things to do' → ['SPORT_', 'CONCERT_', 'THEATER_', 'FESTIVAL_']- 'events happeing near me' → ['SPORT_', 'CONCERT_', 'THEATER_', 'FESTIVAL_']
event_end_datestringThe latest date to include in search results. Format: YYYY-MM-DD. Events on or before this date will be returned. For relative terms like 'next month' or 'this weekend', 'in Decemeber', etc. convert them to specific dates using the LAST day of the specified range.Weekends end on Sunday. 'in December' refers to an event_end_date of 12-31.NEVER USE A DATE BEFORE TODAY. ALL DATES MUST BE TODAY OR LATER.
event_start_datestringThe earliest date to include in search results. Format: YYYY-MM-DD. Events on or after this date will be returned. For relative terms like 'next month' or 'this weekend', 'in Decemeber', etc. convert them to specific dates using the FIRST day of the specified range.Weekends start on Friday. 'in December' refers to an event_start_date of 12-01.NEVER USE A DATE BEFORE TODAY. ALL DATES MUST BE TODAY OR LATER.
intent_levelstringClassify the user's search query intent level. Must be set to either 'HIGH_INTENT' or 'LOW_INTENT'. HIGH_INTENT queries seek specific events, performers, or teams, even if the query is ambiguous or incomplete. HIGH_INTENT includes: - Artist/performer names (full or partial): 'taylor swift', 'zach', 'megan', 'coldplay' - Team names: 'knicks', 'yankees', 'lakers' - Specific events: 'super bowl', 'world series', 'wicked broadway' - Queries with entity + context: 'coldplay las vegas dec 12', 'knicks vs celtics'The key distinction: If the user is searching FOR a specific who/what (even if abbreviated or ambiguous), set to 'HIGH_INTENT'. LOW_INTENT queries are broad, exploratory, or ask what's available. They indicate the user doesn't know what specific event they want yet. LOW_INTENT includes: - Category browsing: 'concerts', 'sports games', 'theater shows', 'comedy' - Location-based discovery: 'concerts in las vegas', basketball games in nyc' - Venue-based discovery: 'events at madison square garden', 'what is at the sphere' - Category + filters: 'nba games in nyc next 60 days', 'college basketball', 'motorsport events' - Genre-based searches: 'rock concerts', 'EDM music', 'broadway shows' - Exploratory: 'what to do', 'things to do in vegas', 'events tonight'The key distinction: If the user is asking what's available in a category/location, set to 'LOW_INTENT'.
HIGH_INTENTLOW_INTENTlocation_coordinatesstringGeographic coordinates to find events near a specific location. Format: 'latitude, longitude' (comma-separated decimal degrees). Examples: '40.730610, -73.935242' for New York City, '34.052235, -118.243683' for Los Angeles, '41.878113, -87.629799' for Chicago. For large areas (states/countries), use central point coordinates. Use when user mentions 'near me', city names, or geographic locations.
venue_namestringThe name of the venue where the event is expected to take place. Use when the user specifically mentions a venue in their query. Examples: 'Madison Square Garden', 'SoFi Stadium', 'Wembley Stadium', 'Sydney Opera House'.