Basic Venue Details

Learn to fetch details for venues using the Discovery API.

We'll cover the following

We can use the venues endpoint to search for venues based on different queries, getting various venues. Apart from this, we can also use this endpoint for retrieving the details of singular venues. A venue ID is required as part of the URL to get venue details.

The diagram below gives an overview of this endpoint:

The URL for this endpoint is:

https://app.ticketmaster.com/discovery/v2/venues/{id}

Here, {id} is the ID of a venue. Apart from this URL parameter, this endpoint also takes a couple of optional query parameters. The table below gives an overview of these parameters:

Parameter

Type

Category

Description

id

string

required

The ID of the venue we want the details for.

locale

string

optional

The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (only en or fr) the first matching locale is used. When using *, it matches all locales. The default value is en.

domain

array[string]

optional

If provided, the results are filtered based on the domain they are available on.

As always, the response is a JSON object containing the venue details. Let's take a look at some of the properties of this response object—you can visit this lesson to see the full details of all the properties:

Property

Type

Description

_links

object

This contains a link to the current dataset.

type

string

The type of the entity. For venues, the value is venue.

id

string

The ID of the venue.

name

string

The name of the venue.

description

string

A description of the venue.

address

object

The address of the venue. It contains a maximum of three properties, with each property representing one line of the address.

city

object

The city the venue is located in. It contains a single property name that holds the name of the city.

state

object

The state the venue is located in. It contains two properties, name and stateCode that hold the name and code of the state respectively.

country

object

The country the venue is located in. It contains two properties, name and countryCode that hold the name and code of the country respectively.

url

string

URL to Ticketmaster's detail page for the venue.

location

object

The location of the venue. It contains two properties, longitude and latitude that hold the longitude and latitude values for the venue.

images

array[object]

The images of the venue. These are represented as an array of objects, with each object holding information regarding an image.

generalInfo

string

The general information regarding the venue, including rules for children.

upcomingEvents

object

The counts of the upcoming events in the venue.

Get venue details

Let's try making an actual call to this endpoint. The list below contains several venues and their IDs which, we can use for this endpoint:

Venue

ID

Madison Square Garden

KovZpZA7AAEA

SoFi Stadium

KovZ917ACh0

United Center

KovZpa2M7e

Dolby Live

KovZ917A5L7

Ball Arena

KovZpZAFaJeA

Try replacing the value of the venue_id variable on line 5 with an ID from the table above to retrieve details for the relevant venue.

Press + to interact
import json

import requests



api_key = '{{API_KEY}}'

venue_id = 'KovZpZA7AAEA'



response = requests.get('https://app.ticketmaster.com/discovery/v2/venues/' + venue_id,

                        params = {

                            'apikey' : api_key,

                        }).json()



print(json.dumps(response, indent=4))

With that, we've successfully retrieved the details for an event. Now, let's look into some of the information that this call provided us with, such as the seat map of the event.

Render venue images

The response object includes an array called images, similar to the images array we get from the event endpoint. However, unlike events, we don't have a dedicated endpoint to fetch images for a venue, so we'll have to use the venue details object to get images for venues.

Let's try doing that now:

Press + to interact
import json

import requests



api_key = '{{API_KEY}}'

venue_id = 'KovZpZA7AAEA'



response = requests.get('https://app.ticketmaster.com/discovery/v2/venues/' + venue_id,

                        params = {

                            'apikey' : api_key,

                        }).json()



image_url = response['images'][0]['url']



print(f'<img src={image_url} width=500px>')

You can try changing the value of the venue_id variable on line 5, or the index on line 12 to fetch and render different images for different venues.

Note: The length of the images array varies across different responses, so you might get an IndexError for index values that are too large.