Overview of Classifications
Learn how events and attractions are classified by Ticketmaster.
How are entities classified?
Ticketmaster categorizes entities into different classifications. These classifications help define the nature of events and attractions. Entities are divided into seventeen classifications, which are further divided into the following:
- Segments: These represent the primary genre by which entities are classified. Examples of segments include sports, music, and theater.
- Genres: These represent the secondary genre for the classification of entities. Examples of genres within the sports segment include basketball, baseball, and badminton.
- Subgenres: These represent the tertiary genre for the classification of entities. Examples of subgenres within the basketball genre include high school basketball, minor league basketball, and NBA.
- Types: A type represents a kind or group of people. Examples of types include donations, groups, and individuals.
- Subtypes: These represent the secondary types to further categorize an entity. Examples of subtypes within the group type include bands, choirs, and choruses.
Classification search
Let's take a closer look at these classifications using the Discovery API. We can use the classifications endpoint to search for and filter classifications.
The URL for this endpoint is given below:
https://app.ticketmaster.com/discovery/v2/classifications
This endpoint takes no required parameters. However, we can use some optional query parameters to filter the search results. The table below provides an overview of some of these parameters—you can visit this lesson to see the complete list:
Parameter | Type | Category | Description |
| string | optional | If provided, the search results are filtered by the classification ID. |
| string | optional | A keyword on which the search is performed. |
| integer | optional | The number of results to be returned per page. The default value is |
| integer | optional | The page number to be returned. The default value is |
| string | optional | The sorting order of the search results. The default value is |
The properties of the response JSON object are identical to the response objects of the previous search endpoints:
Property | Type | Description |
| object | This contains a single property, |
| object | This contains links to the first, next, and last pages in the search results, as well as the link to the current page. |
| object | This contains information regarding the pages of the search results, including the size of each page, the total number of results, the total number of pages, and the current page number. |
As we saw previously with the response objects from the previous search endpoints, the actual search results are stored in the classifications array within the _embedded property. Each object within the array represents one classification.
Let’s make a call to this endpoint, with no optional parameter, as shown in the following code widget:
import jsonimport requestsapi_key = '{{API_KEY}}'response = requests.get('https://app.ticketmaster.com/discovery/v2/classifications',params = {'apikey' : api_key}).json()print(json.dumps(response, indent=4))
Since we made this call without using any optional parameters, the search results contain each of the seventeen classifications. We can confirm this by checking the page propertyhe values of totalElements and totalPages should be 17 and 1 respectively, indicating that we've fetched each classification from Ticketmaster's database.
The response object is quite large, with multiple levels of embedded objects. Each classification contains either a single segment or a single type. Segments further include genres and subgenres, while types include subtypes. We'll cover all of these classifications in further lessons.
Classification details
As we did with the events endpoint, we can also use the classifications endpoint to retrieve details about a particular classification. This endpoint only requires the classification ID as a URL parameter.
The URL for this endpoint is:
https://app.ticketmaster.com/discovery/v2/classifications/{id}
Apart from the classification ID, this endpoint takes a couple of optional query parameters. The table below gives an overview of all these parameters:
Parameter | Type | Category | Description |
| string | required | The ID of the classification we want the details for. |
| string | optional | The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (only |
| array[string] | optional | If provided, the results are filtered based on the domain they are available on. |
The properties of the response JSON object are as follows:
Property | Type | Description |
| object | This contains a link to the current dataset. |
| object | This contains details regarding the related segment, including details of the related genres and sub-genres. |
| object | This contains details regarding the related type, including details of the related sub-types. |
| boolean | This indicates whether the classification is a family classification. |
A single classification will contain either the segment property or the type property. The two are mutually exclusive.
Retrieve classification details
Let's try fetching the details of some classifications. Listed below are some classifications and their IDs, and information on whether they are classified into segments or types:
Name | Further Classification | ID |
Sports | Segment | KZFzniwnSyZfZ7v7nE |
Music | Segment | KZFzniwnSyZfZ7v7nJ |
Arts & Theater | Segment | KZFzniwnSyZfZ7v7na |
Individual | Type | KZAyXgnZfZ7v7la |
Group | Type | KZAyXgnZfZ7v7l1 |
Donation | Type | KZAyXgnZfZ7vAvv |
Try replacing the value of the class_id variable on line 5 to fetch details for different classifications:
import jsonimport requestsapi_key = '{{API_KEY}}'class_id = 'KZFzniwnSyZfZ7v7nE'response = requests.get('https://app.ticketmaster.com/discovery/v2/classifications/' + class_id,params = {'apikey' : api_key}).json()print(json.dumps(response, indent=4))
The response object will include either the segment property or the type property depending on how an entity is classified.