tickets.dev

Events API

free

Find 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: TicketmasterStubHubSeatGeekTickPickVivid SeatsGametimeViagogoGoTicketsPaciolanTelechargeBroadway DirectCirque du Soleil

Try
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.

MethodEndpoint
GET/v1/events
Code to integrate
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.

ParameterTypeDescription
querystringFree 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
prefixbooleanDefault 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.
eventIdstringAn 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
sourcestringOnly 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 / todateISO 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.
pagenumberPage to return, from 1. Default 1, at most 200.
pageSizenumberEvents 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.

FieldTypeDescription
pagenumberThe page served.
pageSizenumberEvents per page as served, after the 100 cap.
totalnumberEvents matching the request, across all pages.
numberOfPagesnumberPages at this pageSize. 0 when nothing matched.
hasMorebooleanWhether a later page exists.
events[].idstringThe catalog id: one id for the event on every marketplace. Pass it back as eventId.
events[].namestringThe event name.
events[].eventDateUtcstring | nullStart time in UTC, ISO 8601. null when the date is not announced.
events[].eventDateLocalstring | nullStart time at the venue as the venue lists it, with its UTC offset when known. null when the date is not announced.
events[].venueobjectname, city, state, country and timezone; any can be null.
events[].performers[]arrayperformerId, name, and master, true for the headliner.
events[].sources[]arrayOne entry per marketplace that lists the event: marketplace, its native eventId, and the event page url.
events[].updatedAtstringWhen 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.

CodeStatusMeaning
missing_key401No key sent. Use the x-api-key header or ?apiKey=.
invalid_key401The key is wrong or revoked.
unknown_marketplace404source is not a marketplace tickets.dev supports.
source_not_indexed501The marketplace is supported by /v1/capture but not in the catalog yet. Applies to source and to URLs from that marketplace.
internal500Something 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.

Code to integrate
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()
⌂ 换网址