Events API
freeFind an event once. Get it on every marketplace.
Send a name, a venue or any marketplace's event URL.
Get back one event with its id and link on every marketplace that lists it: ![]()
![]()
![]()
![]()
![]()
![]()
![]()
![]()
![]()
![]()
GET /v1/events?query=madison+square+gardenSearching…Search the catalog
GET /v1/eventssearches the event catalog. Send a name, a venue or any marketplace's event URL as query; the response lists the matching events, each with its catalog id and its id and link on every marketplace that lists it. Reads are free and never spend a capture. Send your key in the x-api-key header. The sandbox key tk_test_sandbox answers from test fixtures instead of the live catalog. New to it? Start with what the Events API is for.
| Method | Endpoint |
|---|---|
| GET | /v1/events |
import requests
response = requests.get(
"https://api.tickets.dev/v1/events",
params={"query": "madison square garden"},
headers={"x-api-key": api_key},
)
for event in response.json()["events"]:
for source in event["sources"]:
print(event["name"], source["marketplace"], source["url"])Query parameters
Send query or eventId. Everything else narrows or pages the result.
| Parameter | Type | Description |
|---|---|---|
query | string | Free text (an event, performer or venue name) or any marketplace URL. An event page URL resolves to that one event; a venue or performer page URL lists its events. A bare host/path works as well as a full link.?query=madison+square+garden?query=https://www.ticketmaster.com/…/event/3B0064F1B1D64441 |
prefix | boolean | Default true: the last word of query also matches as a prefix, so a search box can query as the user types (kur finds KURIOS). Whole-word matches are listed first, prefix-only ones after. false matches whole words only. |
eventId | string | An exact lookup: a catalog id, or a marketplace's own event id. With source the native id is looked up on that marketplace; without it, on all of them. No match returns an empty page.?eventId=01M0DYPG33R5Y87C6QR9ZPRRX4?source=ticketmaster&eventId=3B0064F1B1D64441 |
source | string | Only events this marketplace sells. Each event still lists its links on every marketplace. In the catalog today: ticketmaster, stubhub, seatgeek, tickpick, vividseats, gametime, viagogo, gotickets, paciolan, telecharge, broadwaydirect, cirquedusoleil. |
from / to | date | ISO 8601 date or date-time. Events starting at or after from and before to. Without from, past events are left out and events with no date yet are kept; set from to an earlier date for history. |
page | number | Page to return, from 1. Default 1, at most 200. |
pageSize | number | Events per page. Default 20, at most 100. Larger values are lowered to 100, and the response echoes the size it served. |
Response
Every request returns the same shape, a page of events, even an exact lookup that matches one event or none. No prices or listing counts: those come from a capture.
| Field | Type | Description |
|---|---|---|
page | number | The page served. |
pageSize | number | Events per page as served, after the 100 cap. |
total | number | Events matching the request, across all pages. |
numberOfPages | number | Pages at this pageSize. 0 when nothing matched. |
hasMore | boolean | Whether a later page exists. |
events[].id | string | The catalog id: one id for the event on every marketplace. Pass it back as eventId. |
events[].name | string | The event name. |
events[].eventDateUtc | string | null | Start time in UTC, ISO 8601. null when the date is not announced. |
events[].eventDateLocal | string | null | Start time at the venue as the venue lists it, with its UTC offset when known. null when the date is not announced. |
events[].venue | object | name, city, state, country and timezone; any can be null. |
events[].performers[] | array | performerId, name, and master, true for the headliner. |
events[].sources[] | array | One entry per marketplace that lists the event: marketplace, its native eventId, and the event page url. |
events[].updatedAt | string | When the catalog last updated this event, ISO 8601. |
A real response for ?query=madison+square+garden&pageSize=1:
{
"page": 1,
"pageSize": 1,
"total": 1073,
"numberOfPages": 1073,
"hasMore": true,
"events": [
{
"id": "01M0DYPG33R5Y87C6QR9ZPRRX4",
"name": "New York Islanders at New York Rangers",
"eventDateUtc": "2026-10-06T23:00:00.000Z",
"eventDateLocal": "2026-10-06T19:00:00-04:00",
"venue": {
"name": "Madison Square Garden",
"city": "New York",
"state": "NY",
"country": "US",
"timezone": "America/New_York"
},
"performers": [
{
"performerId": "606",
"name": "New York Rangers",
"master": true
},
{
"performerId": "600",
"name": "New York Islanders",
"master": false
}
],
"sources": [
{
"marketplace": "gametime",
"eventId": "6a5967758156469bca9e1198",
"url": "https://gametime.co/nhl-hockey/islanders-at-rangers-tickets/10-6-2026-new-york-ny-madison-square-garden/events/6a5967758156469bca9e1198"
},
{
"marketplace": "gotickets",
"eventId": "1822323",
"url": "https://gotickets.com/tickets/1822323/new-york-rangers-tickets/madison-square-garden"
},
{
"marketplace": "seatgeek",
"eventId": "18377597",
"url": "https://seatgeek.com/new-york-rangers-tickets/10-6-2026-new-york-new-york-madison-square-garden/nhl/18377597"
},
{
"marketplace": "stubhub",
"eventId": "161564036",
"url": "https://www.stubhub.com/new-york-rangers-new-york-tickets-10-6-2026/event/161564036/"
},
{
"marketplace": "ticketmaster",
"eventId": "3B0064F1B1D64441",
"url": "https://www.ticketmaster.com/new-york-rangers-vs-new-york-new-york-new-york-10-06-2026/event/3B0064F1B1D64441"
},
{
"marketplace": "vividseats",
"eventId": "7301393",
"url": "https://www.vividseats.com/new-york-rangers-tickets-madison-square-garden-10-6-2026/production/7301393"
}
],
"updatedAt": "2026-08-21T16:35:08.929Z"
}
]
}The same endpoint, with every parameter and field, is in the OpenAPI 3.1 spec.
Errors
Errors return a JSON body with a stable code to branch on, a message, whether the request is retryable, and a request_id for support.
| Code | Status | Meaning |
|---|---|---|
missing_key | 401 | No key sent. Use the x-api-key header or ?apiKey=. |
invalid_key | 401 | The key is wrong or revoked. |
unknown_marketplace | 404 | source is not a marketplace tickets.dev supports. |
source_not_indexed | 501 | The marketplace is supported by /v1/capture but not in the catalog yet. Applies to source and to URLs from that marketplace. |
internal | 500 | Something failed on our side. Safe to retry. |
Then capture what you found
Each sources[].url is a marketplace event page. Pass it to /v1/capture?url= for live listings and prices on that marketplace; the marketplace is read from the URL. A capture spends one capture from your plan. The ticket scraping API documents the snapshot it returns.
import requests
headers = {"x-api-key": api_key}
# 1. Find the event (free).
events = requests.get(
"https://api.tickets.dev/v1/events",
params={"query": "madison square garden"},
headers=headers,
).json()["events"]
# 2. Capture it on one of its marketplaces (one capture).
url = events[0]["sources"][0]["url"]
snapshot = requests.get(
"https://api.tickets.dev/v1/capture",
params={"url": url},
headers=headers,
).json()