Search events
/v1/events/searchModern replacement for the v0.3.1 POST search. Returns event metadata
with standardization (normalized venue name, country, lat/lng, slug,
performer, tour name) flattened into each item. Use this to discover
event_id values for the paid stats endpoint.
No charge per call.
Pricing principle
This endpoint returns metadata only - never time-series or aggregate data derived from observed marketplace activity. Sales/listings data is paid via the dedicated endpoints.
Pagination
Cursor-based. Pass starting_after with the value from next_cursor
to fetch the next page. Cursors expire after 1 hour.
Pass Authorization: Bearer <api_key>. Preferred for new integrations.
In: header
Query Parameters
Partial match on event name, including alternate names where available
Partial date match (e.g., 2026-05)
Partial match on standardized venue name (raw fallback when not normalized)
Partial city match
Partial state match (2-letter or full)
Exact match on standardized country code (e.g., US, CA, GB)
Exact match on primary ticketing marketplace event id
Returns all events for a given standardized performer/tour
Returns all events at a given standardized venue
Exact match on standardized venue slug
true includes past events; default future-only
falseMax items per page (default 100, max 200)
value <= 200100Cursor token from a previous response's next_cursor
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/events/search?event_name=Taylor+Swift" \ -H "Authorization: Bearer YOUR_API_KEY"{ "data": [ { "event_id": 589342, "event_name": "Taylor Swift | The Eras Tour", "event_date": "2026-06-15", "event_time": "19:00", "tm_event_id": "G5vYZbvoZ1C-r", "days_on_seatdata": 47, "first_seen_date": "2026-03-11", "venue_name": "MetLife Stadium", "venue_city": "East Rutherford", "venue_state": "NJ", "venue_country_code": "US", "venue_country": "United States", "venue_lat": 40.8136, "venue_lng": -74.0746, "venue_slug": "metlife-stadium-east-rutherford-nj", "venue_tm_id": "KovZpZA7AAEA", "std_event_id": 8821, "std_venue_id": 412, "performer": "Taylor Swift", "event_type": "concert", "tour_name": "The Eras Tour" } ], "has_more": true, "next_cursor": "string"}Get usage GET
Returns API call counts for the current billing period, plus a per-endpoint breakdown showing which endpoints have the most usage. - `period_start` - start of the current billing cycle. - `period_end` - end of the current billing cycle (next renewal date). - `totals` - counts of calls in `[period_start, now]`. Right after a renewal, all counts will be near 0. For accounts created before billing-period tracking was added, the window may fall back to a rolling 30-day lookback. No charge per call.
Get event stats GET
Returns the historical event_stats time series for a single event. Each snapshot row includes event-level aggregates (avg/median price, get-in price, listing fill rate) AND inline zone-level breakdowns for every zone in that snapshot. ## Billing rules | Scenario | Charged a pull? | |---|---| | First request for an event (no cursor, snapshots exist) | Yes - 1 pull | | Follow-up paginated page (cursor present) | No (continuation) | | Repeat first-page request, no new snapshot since last paid pull | No (freshness rule) | | Repeat first-page request, new snapshot logged in between | Yes - 1 pull | | Event has no event_stats rows yet | No (empty result, free) | The freshness rule means polling for "is there fresh data?" only costs when there's actually new data to consume. ## Pagination Cursor-based. The first page response includes `total_count` and `available_zones`; subsequent paginated pages omit them. Cursors expire after 1 hour.