Ticketmaster Discovery API Guide: What It Does, Pricing Data & Limitations

Access, cost and limits

Base URL

https://app.ticketmaster.com/discovery/v2/

Access

An API key from a free Ticketmaster developer account, sent as the apikey query parameter

Cost

No paid tier is listed; every new account gets access by default

Data

Events, attractions (performers and teams), venues and classifications

Coverage

230,000+ events across the US, Canada, Mexico, Australia, New Zealand, the UK, Ireland and other European countries

Pricing data

A priceRanges field in the docs, missing from all but 3 of the 4,000+ events we checked

Default limits

5,000 calls a day and 5 requests a second, confirmed in testing (the FAQ says 2)

Paging

Up to 200 results a page, and paging stops around the 1,000th result

Speed

0.17 to 0.9 seconds per call in our tests

What the Discovery API does

Discovery is a catalog. It's built for apps that list events and send fans to Ticketmaster to buy: a venue calendar, a city guide, a "who's playing near me" feature. Here's a search for Bruno Mars at SoFi Stadium on October 6, 2026, and what came back:

curl -G https://app.ticketmaster.com/discovery/v2/events.json \
  --data-urlencode "keyword=bruno mars" \
  --data-urlencode "city=Inglewood" \
  --data-urlencode "startDateTime=2026-10-06T00:00:00Z" \
  --data-urlencode "endDateTime=2026-10-08T00:00:00Z" \
  --data-urlencode "apikey=$TICKETMASTER_KEY"

{
  "name": "Bruno Mars - The Romantic Tour",
  "id": "vvG1IZ_eheCVin",
  "url": "https://www.ticketmaster.com/bruno-mars-the-romantic-tour-inglewood-california-10-06-2026/event/0A006426C23B4B2A",
  "dates": {
    "start": {
      "localDate": "2026-10-06",
      "localTime": "19:00:00"
    },
    "status": {
      "code": "onsale"
    }
  },
  "sales": {
    "public": {
      "startDateTime": "2026-01-15T20:00:00Z",
      "endDateTime": "2026-10-07T04:00:00Z"
    },
    "presales": [
      {
        "name": "Artist Presale",
        "startDateTime": "2026-01-14T21:15:00Z"
      }
    ]
  },
  "ticketLimit": {
    "info": "There is an overall 6 ticket limit for this event."
  },
  "seatmap": {
    "staticUrl": "https://mapsapi.tmol.io/maps/geometry/3/event/0A006426C23B4B2A/staticImage?type=png&systemId=HOST"
  },
  "ticketing": {
    "safeTix": {
      "enabled": true
    },
    "allInclusivePricing": {
      "enabled": true
    }
  },
  "_embedded": {
    "venues": [
      {
        "name": "SoFi Stadium",
        "city": {
          "name": "Inglewood"
        }
      }
    ]
  }
}

For buying tickets, that's what Discovery has on this show: when sales opened, the presales, a six-ticket limit, a picture of the seat map and a link.

What Discovery is good at

For anything built around events and on-sale dates, Discovery does the job well:

• Local event listings. Search by point and radius and sort by date or distance. A search within 10 miles of SoFi Stadium for one week returned 204 events, from the Hollywood Pantages to the Whisky a Go Go and the Blue Note, each with venue, lineup and images.
• On-sale and presale alerts. Every event carries its public on-sale window, and 59% of the US events we sampled listed their presales with start times. You can search by on-sale date directly, and the status field marks events that are canceled or rescheduled.
• Artist and team pages. Attractions come with images, genres, a count of upcoming events and links to their other profiles. Bruno Mars had 11, from Spotify to MusicBrainz, so you can tie Ticketmaster events to music and social data.
• Search-as-you-type. /suggest returns events, performers, venues and add-ons in one call, fast enough for a search box: every call we made answered in under a second.
• Earning from ticket sales. Event links can carry your affiliate id, so fans who buy through your app earn you a commission.

What its pricing data tells you

Each event can carry a priceRanges array. The docs describe it as "price ranges of this event", with this example:

"priceRanges": [
  {
    "type": "standard",
    "currency": "USD",
    "min": 80,
    "max": 80
  }
]

In practice, it's almost never there. We checked every event on the first four pages of US music, sports and theater searches through the end of 2026: 2,397 events. Only 3 had a priceRanges, all small film screenings with a single price. Another 2,000 events across Canada, the UK, Australia, Ireland and Mexico had none.

• 3 of 2,397 US events had a price range
• 0 of 2,000 events in the five other countries did

Ticketmaster removed it on purpose. Its release notes for the Discovery Feed, the bulk export of the same catalog, say that on March 11, 2025, "Discovery priceRanges removed from feeds", and that the Feed's price fields "will always be null". The Discovery API reference still documents the field, but the live API matches the Feed.

Limitations

Discovery has no endpoint for any of these: individual listings, seat-level prices, how many tickets are left, resale listings, the fee on a ticket, or what tickets sold for.

Getting listing-level prices

Tickets.dev captures the event page itself and returns every listing on it:

1. Event URLFrom Discovery's url field, or any marketplace
2. Live captureThe page loaded in a real browser, right now
3. Every listingSection, row, quantity, price, fee and all-in total

Discovery's url field is the Ticketmaster event page, so the two fit together: find events with Discovery, then capture the ones you care about.

curl -G https://api.tickets.dev/v1/capture/ticketmaster \
  --data-urlencode "url=https://www.ticketmaster.com/bruno-mars-the-romantic-tour-inglewood-california-10-06-2026/event/0A006426C23B4B2A" \
  -H "x-api-key: $TICKETS_DEV_KEY"

The response has every listing on the page in one schema, plus the venue's seat map. The same call works for StubHub, Vivid Seats, SeatGeek and the other supported marketplaces.

To find the same show on those marketplaces, pass the Ticketmaster URL from Discovery's url field to the free events API. It returns the event with its URL on every marketplace that lists it, ready to capture:

curl -G https://api.tickets.dev/v1/events \
  --data-urlencode "query=https://www.ticketmaster.com/bruno-mars-the-romantic-tour-inglewood-california-10-06-2026/event/0A006426C23B4B2A" \
  -H "x-api-key: $TICKETS_DEV_KEY"

For the Bruno Mars show it found the event on six marketplaces: Ticketmaster, StubHub, SeatGeek, Vivid Seats, Gametime and GoTickets. The events API is free and has no rate limit.

To turn captures into price history, see our price tracking guide.