Search Events
search_eventsRead-only
Finds ticketed events by name, performer, venue or date, and by on-sale, presale or added dates, and returns their event ids. Use it when the person names an event, act or venue, or when a later call needs an event id. It also lists events a page at a time by category, venue capacity, primary tickets left, TM resale get-in, resale-to-primary or completed sales. To filter or rank events by any other price, demand or inventory number, use screen_events. Rows from other tools already carry event_id and event_url, so a second search for the same event is not needed.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | The page to read, from 1. Default 1. | |
| limit | No | Rows per page. A page too large for one tool result comes back as the first rows plus `meta.truncated` and `meta.total_rows`; narrow the search or the dates rather than repeating the call. | |
| query | No | Alias for `search`; prefer `search`. Ignored when `search` is also present. | |
| search | No | Ranking words (hottest, best, top, movers) are a sort on screen_events, never search text. NOT A LINK RESOLVER: rows from other tools already carry `event_id` and `event_url`; matching a row by name can land on a different event. A marketplace event link or id is not search text either: pass it as `event_id` to an event tool. Names only: event, performer or venue (min 2 chars), e.g. "taylor swift", "lakers", "Madison Square Garden". Words match in any order: each word of 3 or more letters must be in the event's name, its performer or its venue, so "Red Sox Yankees" finds the game. Joining words (vs, and, the) are ignored. Rows whose name holds every word come first, and inside each group the events Ticker covers most closely, then the soonest. Not a ranking word (hottest, best, top, movers) and not a typo of one. A venue term returns the events playing there. Venues are stored under their official name, so expand a nickname ("MSG") before searching. Omit to browse by filters alone; use screen_events to rank. | |
| status | No | Filter by event status. Default 'active', the live universe. When the first page of a search with text finds nothing it is re-run over every status and the result says retried_including_inactive: true; each row carries currently_priced (false = the event exists but is not priced right now). | active |
| date_to | No | Event date on/before this instant (ISO 8601, offset ok, over utc_date). | |
| parking | No | Parking events: a parking pass that is its own event (sub_category_id 75 or 'Parking' in the name). `hide` (the default) leaves them out; `only` returns parking alone; `include` returns parking beside every other event. Set `only` when the user asks for parking, `include` when they want both; leave it at `hide` otherwise. Under hide a search for 'parking' by name still finds parking. | hide |
| sort_by | No | Sort key. Default utc_date; with search text and no sort_by, the closest name matches come first. Sorting by onsale_date or presale1_date keeps the events where that date is known (only a minority carry sale dates). sold_24h keeps the events with a completed sale in the last 24 hours, most first. | |
| venue_id | No | Restrict to one venue. Ticker venue id, `vn` plus ten characters. A marketplace id also resolves with its `vs:` prefix, and bare until 2027-09-13. | |
| date_from | No | Event date on/after this instant (ISO 8601, offset ok, over utc_date). | |
| onsale_to | No | Public on-sale on/before this instant. Events with no known on-sale date are excluded. | |
| created_to | No | Ticker discovered the event on/before this instant. | |
| presale_to | No | First presale on/before this instant. Events with no known presale date are excluded. | |
| sort_order | No | Default asc (soonest first), the natural discovery order; for sold_24h desc (most first). | |
| category_id | No | Only this category. | |
| onsale_from | No | Public on-sale on/after this instant. Events with no known on-sale date are excluded. | |
| sold_1d_min | No | At least this many completed sales in the last day. | |
| sold_3d_min | No | At least this many completed sales in the last 3 days. | |
| sold_7d_min | No | At least this many completed sales in the last 7 days. | |
| capacity_max | No | The venue's seats, at most this. | |
| capacity_min | No | The venue's seats, at least this. | |
| created_from | No | Ticker discovered the event on/after this instant. | |
| include_past | No | Include events whose date is already past. Default false (upcoming only). When true without an explicit date_from, results are bounded to the last 90 days. | |
| performer_id | No | Restrict to events headlined by one performer. Ticker performer id, `pf` plus ten characters, as returned by every tool here. A marketplace id also resolves with its `vs:` prefix, and bare until 2027-09-13. | |
| presale_from | No | First presale on/after this instant. Events with no known presale date are excluded. | |
| presale_scope | No | Match the presale range against the first presale (default) or any named presale. | |
| tmr_get_in_max | No | The lowest all-in price on TM resale, in dollars, at most this. | |
| tmr_get_in_min | No | The lowest all-in price on TM resale, in dollars, at least this. | |
| primary_left_max | No | Primary tickets still on sale, at most this. | |
| primary_left_min | No | Primary tickets still on sale, at least this. | |
| primary_sold_max | No | Percent of the primary house taken, 0 to 100, at most this. | |
| primary_sold_min | No | Percent of the primary house taken, 0 to 100, at least this. | |
| monitoring_priority | No | Filter by exact coverage tier (1=high … 10=low). | |
| resale_to_primary_max | No | The resale get-in divided by the primary get-in, all-in, at most this. | |
| resale_to_primary_min | No | The resale get-in divided by the primary get-in, all-in, at least this. | |
| monitoring_priority_max | No | Coverage tier, at most this (1=high, 10=low). | |
| monitoring_priority_min | No | Coverage tier, at least this (1=high, 10=low). |