Search artists, teams, venues and events
search_catalogRead-onlyIdempotent
Use this when the user names an artist, team, venue or event and you need the matching TicketSea records. Ranked search with prefixes, aliases and labeled one-edit corrections. Artist and venue matches are worldwide; an event radius needs a city ID or a full City, Region, Country label. Results are cached listings, not live inventory. For a dated list of events with seller links, use search_events.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| city | No | City the user asked about: a TicketSea city ID or an exact City, Region, Country label. Required for a distance radius. | |
| from | No | ||
| mode | No | suggest is a bounded autocomplete preview without pagination; short prefixes match names and aliases. Use results for full context matching and pagination. | results |
| sale | No | soon selects events whose public on-sale has not started yet. Give a specific query (an artist or a city name) with it; use radius 200 for local on-sales. | |
| type | No | Limit results to one record type. | |
| limit | No | ||
| query | No | Artist, team, venue or event name, or the start of one. | |
| offset | No | ||
| radius | No | Miles around city for event results. | anywhere |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| groups | Yes | ||
| notice | Yes | ||
| radius | No | ||
| location | No | ||
| indexStale | Yes | ||
| correctedQuery | No | ||
| indexUpdatedAt | Yes |