find_events
Search for events by performer, location, date, or venue using structured queries. Returns detailed event data including venue information for ticketed entertainment.
Instructions
Search for events by performer, location, date, or venue. This tool is optimized for finding specific events based on user queries. If the query involves a performer, it first looks up the performer, then finds events for that performer. Otherwise, it searches events directly. Returns structured event data with venue information.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_utc | No | End date filter in ISO8601 UTC format (YYYY-MM-DD). Use with start_utc to define date ranges. | |
| format | No | Output format. Use "structured" for readable format (default) or "json" for raw API response. Only use "json" if explicitly requested. | structured |
| page | No | Page number for pagination. Default is 1. | |
| per_page | No | Number of results to return per page (1-50). Default is 10. | |
| q | No | Free-text search term. Use only when no other specific filters match the user request. Keep this text to pronouns if present in the user's query unless there are no pronouns in the query. Never duplicate information already captured in other parameters. | |
| start_utc | No | Start date filter in ISO8601 UTC format (YYYY-MM-DD). Use for date ranges like "next month" or "this weekend". | |
| venue_city | No | City name where the venue is located. Use full city name, e.g., "New York" or "Los Angeles". | |
| venue_country | No | Country code where the venue is located, e.g., "US" for United States or "CA" for Canada. | |
| venue_state | No | State abbreviation where the venue is located, e.g., "CA" for California or "NY" for New York. |