Top Picks API

The Top Picks API provides seat recommendations based on current availability, sampling across various areas of a venue and available price points. Results are near real-time but for certain high velocity events picks may expire (sell out) quickly.

Make live API calls right now in the interactive docs:

INTERACTIVE DOCS

Overview

Authentication

Clients will be provided an API key from Ticketmaster which should be added to every resource endpoint call.

Example: https://app.ticketmaster.com/top-picks/v1/events/3F004EC9D1EBBC76?apikey=3QIvq55bS608ai6r8moig1WdW57bONry

Host and API endpoint information

https://app.ticketmaster.com/top-picks/v1

All connections must be made over SSL using https.

Terms and Conditions

By using the Ticketmaster Developer Portal, you understand and agree to our Terms of Use.

Contact

Ticketmaster Developer Program developer@ticketmaster.com.

Service Availability

The Ticketmaster back-end reservation systems are distributed globally and events are processed on their local systems. These systems go into a nightly maintenance mode at 2AM local time. This means a show playing at Madison Square Garden will not be transactable between 2-3AM Eastern Time. Use the timezone value from the event details response to note when these events may be unavailable for transactions.

Top Picks Details [GET]

Retrieve reservable seat information based on specific criteria.

/top-picks/v1/events/{event_id}?apikey={apikey}

URL Parameters

Parameter Description Type Example Required
event_id The 16-digit alphanumeric event ID. string “0B004ED9FC825ACB” Yes

Query Parameters

Parameter Description Type Example Required
apikey Your API Key string GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne Yes
quantity Quantity of tickets number 2 No (default=2)
ticketTypeId Ticket type ID string 000000000001 No
priceLevels Comma-separated price Levels to search numbers 0,1 No
areas Comma-separated area IDs to search numbers 10,11 No
sections Comma-separated section names string GA,103,201 No
prices Price range numbers 50,150 No
page Page number numbers 1 No
limit Elements per page numbers 10 No (default=30)
selection Type of Ticket string Any, Standard, Resale(Resale is only available for select apikeys specifically configured for that.) No

Response structure:

  • page (object) - Page information.
    • number (number) - current page number counted from 1.
    • size (number) - size of current page (max=30 per page).
    • totalElements (number) - total number of elements available.
    • totalPages (number) - total number of pages available.
  • picks (array) - Picks.
    • {array item object} - pick.
      • type (string) - “general-seating”, or “seats”
      • quality (number) - A quality score representing a combination of price and location to stage.
      • area (object) - An area information
        • id (string) - Area id
        • name (string) - Area name
        • description (string) - Area description
      • descriptions (array) - A list of descriptions for this pick
      • section (string) - The section name in the venue
      • selection (string) - “standard”, or “resale”.
      • row (string) - The row in the section, if applicable (not available during onsale).
      • snapshotImageUrl - An image url of this pick in the venue. If the venue or event doesn’t support detailed images, this field will be null.
      • offers (array) - Offers.
        • {array item object} - offer.
          • offer id (string) - The offer id corresponding to one in _embedded.offer[].
      • seats (array) - Seats (not available during onsale).
        • {array item object} - seat.
          • seat id (string) - seat names.
  • _embedded (object) - container for events.
    • offer (array) - Offers matching those found in picks[] items.
      • {array item object} - offer.
        • offerId (string) - The offer id.
        • name (string) - Name of the offer.
        • ticketTypeId (string) - Ticket type id required for reserves.
        • priceLevelId (string) - Price level id (optional for reserves).
        • description (string) - Description of the offer.
        • currency (string) - ISO 4217 currency code.
        • faceValue (number) - Face value of one ticket.
        • totalPrice (number) - Total price including charges (may not include order processing fees).

        • charges (array) - Charges.
          • {array item object} - charge.
            • reason (string) - Name of charge.
            • type (string) - Type of charge.
            • amount (number) - Amount of charge

Request Response

https://app.ticketmaster.com/top-picks/v1/events/1C00506FB56F338A?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne&areas=10,11&prices=70,150&quantity=4&ticketTypeId=000000000001&sections=103
Status 200
{
  "page" : {
        "number" : 2,
        "size" : 15,
        "totalElements" : 35,
        "totalPages" : 2
    },
  "picks": [
    {
      "type": "seats",
      "quality": 0.626072,
      "section": "103",
        "selection": "standard",
      "row": "18",
      "descriptions": [
          "Full View"
      ],
      "area" : {
        "id" : 10,
        "name" : "L100",
        "description" : "LOWER BOWL"
      },
      "snapshotImageUrl": "https://app.ticketmaster.com/maps/geometry/3/event/1C00506FB56F338A/image?systemId=HOST&segmentIds=s_10,s_11,s_113,s_114,s_115,s_116,s_117,s_118,s_119,s_12,s_120,s_13,s_14,s_16,s_17,s_18,s_2,s_22,s_5,s_6,s_8,s_9&placeId=GEYDGORRHA5DS",
      "offers": [
        "GJ6DC7BQ"
      ],
      "seats": [
          "1",
          "2"
      ]
    }
  ],
  "_embedded": {
    "offer": [
      {
        "offerId": "GJ6DC7BQ",
        "name": "Standard Ticket",
        "ticketTypeId": "000000000001",
        "priceLevelId": "0",
        "description": "Standard Ticket",
        "currency": "USD",
        "faceValue": 76.5,
        "totalPrice": 93.25,
        "charges": [
          {
            "reason": "service",
            "type": "fee",
            "amount": 13.75
          },
          {
            "reason": "facility",
            "type": "fee",
            "amount": 3
          }
        ]
      }
    ]
  }
}

Snapshot Image [GET]

A visual-representation of the approximate location of seats in the venue. Each result from the Top Picks API contains a snapshotImageUrl of a .png image.

Query Parameters

All query parameters in snapshotImageUrl must be maintained and un-altered. Clients may add the following:

Parameter Description Type Example Required
w The width, in pixels, of the image. (min: 102, max: 1024) number 300 No
pw The width, in pixels, of the dropped pin in the image. number 30 No
apikey Your API Key string “GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne” Yes

pick image

Example use of Top Picks data

pick image