Find upcoming events
search_eventsRead-onlyIdempotent
Use this when the user wants upcoming concerts, sports, theatre or other live events by performer or event name, city, country, category or dates. Returns cached provider listings in date order. Each event has its TicketSea page (url) and, when a fresh exact-event seller link exists, a tickets link to that seller's page. Not live inventory, and nothing is purchased. Use nextOffset to page, and narrow the filters when scanLimited is true.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| city | No | City the user asked about, as an exact city name (case-insensitive), such as Seattle. Location is never inferred. | |
| from | No | ||
| kind | No | ||
| limit | No | ||
| query | No | Artist, team, event or venue text. | |
| offset | No | ||
| country | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| events | Yes | ||
| notice | Yes | ||
| hasMore | Yes | ||
| sources | Yes | ||
| coverage | Yes | ||
| nextOffset | Yes | ||
| scanLimited | Yes |