Table of Contents
Child pages (Children Display) | ||||||
---|---|---|---|---|---|---|
|
Some Basic Terminology
The Ticket Evolution API includes Performers, Venues, Configurations, Events, and Ticket Groups.
Performers
Performers are an entity who will be playing/competing/performing at the Event. A performer could be a
- Band (Guns ‘N’ Roses)
- Team (New Orleans Saints)
- Individual musician (Billy Joel)
- Speaker (Dave Ramsey)
- Comedian (Amy Schumer)
- Annual Event (Kentucky Derby)
- Play/Musical/Theatrical Performance (Hamilton)
Venues
Venues are the specific locations where an event/game/performance takes place. Some examples:
- Madison Square Garden
- Fenway Park
- Mercedes-Benz Superdome
Configurations
Venues have one or more configurations which is a layout or stage setup for particular events such as sports, concerts, or even specific concert tours where the stage is a custom layout. Each configuration will include a static seating chart.
Events
Events are the individual performances/competitions for which you are buying/selling tickets. Every event includes at least one Performer (but may have many) at a single Venue at a specific time (the {{occurs_at}} property). When an event is a game the “home team” Performer will be marked as primary
and the “away team” will not. When an event is a concert with multiple bands/musicians the “headliner” will be marked as primary
and any “opening bands” will not.
Some events may include a performer that is also the name of the event. An example of this is the Super Bowl. All year long the Super Bowl event will have a single Performer named Super Bowl, but as the teams that will be playing are decided they will be added to the event resulting in having three Performers attached to the event: Atlanta Falcons (primary
since they were designated as the “home team”), New England Patriots, and Super Bowl.
Ticket Groups
Ticket Groups are collections of adjacent seats owned by the same supplier and could there be a single ticket or dozens of tickets within that ticket group. The cost of each ticket within the ticket group is the same and all seats purchased from the ticket group will be adjacent.
See
Listing Events Near Your Visitors
Many sites include a list of upcoming events near the visitor based on geolocation of the visitor’s IP address. The Events / Index endpoint accepts several different options for location but the recommended one is to send lat
and lon
of the visitor along with a within
radius for the venues.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
curl -i \
-X GET \
-H "X-Signature: 5tsKHA+v8xm3HPPqcG9rNhu7+GqYB4N77tTk7tr/FKQ=" \
-H "X-Token: SabreHackathon:TTX2017LasVegasNV" \
--url 'https://api.sandbox.ticketevolution.com/v9/events?lat=36.1207804&lon=-115.156559&order_by=events.occurs_at&page=1&per_page=10&within=20' |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
$response = $client->listEvents([
'page => 1,
'per_page => 10,
'lat => 36.1207804,
'lon => -115.156559,
'within => 20,
'order_by' => 'events.occurs_at',
])); |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
@event = @connection.events.list({
'page => 1,
'per_page => 10,
'lat => 36.1207804,
'lon => -115.156559,
'within => 20,
'order_by' => 'events.occurs_at',
})
|
Comprehensive Search
Every site should have a comprehensive search available on most every page including possibly making it the main feature of the homepage. Once a visitor is has selected an event for which to view tickets and throughout the purchase process it probably makes sense to not show the search and instead use that space for useful elements.
It is suggested that this main search performs a search across Performers, Venues, and Events.
Comprehensive Search can be done via two different endpoints and you should experiment with both and decide which you prefer based on the experience you choose to present to the user.
/searches/suggestions
The /searches/suggestion
endpoint was created to be used in an auto-suggest type of selector.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
curl -i \
-X GET \
-H "X-Signature: IKE8qY1xcCqHKoJFOC+Ett/Xpy5pzkXdCRQh5YflTCs=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/searches/suggestions?entities=events,performers,venues&fuzzy=true&limit=6&q=diamondbacks' |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
$response = $client->listSearchSuggestions([
'entities' => 'events,performers,venues',
'fuzzy' => true,
'limit' => 6,
'q' => 'diamondbacks',
])); |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
@search = @connection.searches.suggestions({
'entities' => 'events,performers,venues',
'fuzzy' => true,
'limit' => 6,
'q' => 'diamondbacks'
}) |
Code Block | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"total_entries": 3,
"suggestions": {
"events": [{
"id": 1073656,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-08-05T18:05:00Z"
}, {
"id": 1073663,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-09-16T18:05:00Z"
}, {
"id": 1073718,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-09-17T13:05:00Z"
}, {
"id": 1073688,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-08-04T19:15:00Z"
}, {
"id": 1073709,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-08-06T13:05:00Z"
}, {
"id": 1073695,
"type": "events",
"name": "Arizona Diamondbacks at San Francisco Giants",
"slug": null,
"location": "San Francisco, CA",
"company": null,
"venue_name": "AT&T Park",
"occurs_at": "2017-09-15T19:15:00Z"
}, {
"id": 1073465,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-07-04T18:10:00Z"
}, {
"id": 1073457,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-09-05T19:10:00Z"
}, {
"id": 1073470,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-07-06T19:10:00Z"
}, {
"id": 1073502,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-07-05T19:10:00Z"
}, {
"id": 1073481,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-09-04T17:10:00Z"
}, {
"id": 1073415,
"type": "events",
"name": "Arizona Diamondbacks at Kansas City Royals",
"slug": null,
"location": "Kansas City, MO",
"company": null,
"venue_name": "Kauffman Stadium",
"occurs_at": "2017-09-30T18:15:00Z"
}, {
"id": 1073447,
"type": "events",
"name": "Arizona Diamondbacks at Kansas City Royals",
"slug": null,
"location": "Kansas City, MO",
"company": null,
"venue_name": "Kauffman Stadium",
"occurs_at": "2017-09-29T19:15:00Z"
}, {
"id": 1073504,
"type": "events",
"name": "Arizona Diamondbacks at Los Angeles Dodgers",
"slug": null,
"location": "Los Angeles, CA",
"company": null,
"venue_name": "Dodger Stadium",
"occurs_at": "2017-09-06T19:10:00Z"
}, {
"id": 1073565,
"type": "events",
"name": "Arizona Diamondbacks at Chicago Cubs",
"slug": null,
"location": "Chicago, IL",
"company": null,
"venue_name": "Wrigley Field",
"occurs_at": "2017-08-03T13:20:00Z"
}, {
"id": 1073445,
"type": "events",
"name": "Arizona Diamondbacks at Kansas City Royals",
"slug": null,
"location": "Kansas City, MO",
"company": null,
"venue_name": "Kauffman Stadium",
"occurs_at": "2017-10-01T14:15:00Z"
}, {
"id": 1073597,
"type": "events",
"name": "Arizona Diamondbacks at Chicago Cubs",
"slug": null,
"location": "Chicago, IL",
"company": null,
"venue_name": "Wrigley Field",
"occurs_at": "2017-08-02T19:05:00Z"
}, {
"id": 1073566,
"type": "events",
"name": "Arizona Diamondbacks at Chicago Cubs",
"slug": null,
"location": "Chicago, IL",
"company": null,
"venue_name": "Wrigley Field",
"occurs_at": "2017-08-01T19:05:00Z"
}, {
"id": 1076260,
"type": "events",
"name": "Arizona Diamondbacks at St. Louis Cardinals",
"slug": null,
"location": "St Louis, MO",
"company": null,
"venue_name": "Busch Stadium",
"occurs_at": "2017-07-28T19:15:00Z"
}, {
"id": 1076261,
"type": "events",
"name": "Arizona Diamondbacks at St. Louis Cardinals",
"slug": null,
"location": "St Louis, MO",
"company": null,
"venue_name": "Busch Stadium",
"occurs_at": "2017-07-29T18:15:00Z"
}],
"performers": [],
"venues": []
}
} |
/search
The /search
endpoint is similar to above.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
curl -i \
-X GET \
-H "X-Signature: SAk9DIBXiITAJzwmx5RmTDEEqpGzxsGXh4QNSWB4Jig=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/search?order_by_popularity=true&page=1&per_page=6&q=diamondbacks&types=events,performers,venues' |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
$response = $client->search([
'order_by_popularity' => true,
'page' => 1,
'per_page' => 6,
'q' => 'diamondbacks',
'types' => 'events,performers,venues',
]); |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
@search = @connection.search.list({
'order_by_popularity' => true,
'page' => 1,
'per_page' => 6,
'q' => 'diamondbacks',
'types' => 'events,performers,venues'
}) |
Code Block | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"total_entries": 6,
"results": [{
"id": 1073656,
"url": "/events/1073656",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-08-05T18:05:00Z",
"updated_at": "2017-06-18T12:10:17Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 1326,
"_type": "Event",
"_score": 1.5675107
}, {
"id": 1073663,
"url": "/events/1073663",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-09-16T18:05:00Z",
"updated_at": "2017-06-18T12:13:37Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 1392,
"_type": "Event",
"_score": 1.5665506
}, {
"id": 1073718,
"url": "/events/1073718",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-09-17T13:05:00Z",
"updated_at": "2017-06-18T12:13:41Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 2084,
"_type": "Event",
"_score": 1.5662595
}, {
"id": 1073688,
"url": "/events/1073688",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-08-04T19:15:00Z",
"updated_at": "2017-06-18T12:10:07Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 2325,
"_type": "Event",
"_score": 1.559197
}, {
"id": 1073709,
"url": "/events/1073709",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-08-06T13:05:00Z",
"updated_at": "2017-06-18T12:10:21Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 1910,
"_type": "Event",
"_score": 1.552449
}, {
"id": 1073695,
"url": "/events/1073695",
"name": "Arizona Diamondbacks at San Francisco Giants",
"occurs_at": "2017-09-15T19:15:00Z",
"updated_at": "2017-06-18T12:13:32Z",
"category": {
"category": {
"id": 3,
"parent_id": 2,
"name": "MLB",
"keywords": null,
"created_at": "2010-07-30T17:39:58Z",
"updated_at": "2014-05-08T13:12:31Z",
"multi_venue": false,
"has_home_team": true,
"seatgeek_id": null,
"deleted_at": null,
"slug": "mlb",
"top_parent_id": 1
}
},
"configuration": {
"configuration": {
"id": 2364,
"venue_id": 1172,
"name": "Baseball",
"capacity": null,
"primary": true,
"dynamic_map_key": "6635",
"created_at": "2010-09-24T20:18:27Z",
"updated_at": "2015-04-07T06:21:37Z",
"static_map_file_name": "1172_2364.jpg",
"static_map_content_type": "image/jpeg",
"static_map_file_size": 325636,
"static_map_updated_at": "2015-04-07T06:21:35Z",
"ga": false,
"map_not_available": false,
"deleted_at": null,
"search_terms": "'att':2 'basebal':1 'park':3",
"seat_geek_configuration_id": null,
"dvm_configuration_id": 32
}
},
"venue": {
"venue": {
"id": 1172,
"address_id": 209244,
"name": "AT&T Park",
"keywords": "",
"created_at": "2010-07-30T18:07:53Z",
"updated_at": "2014-05-08T13:11:09Z",
"allow_duplicate_section_numbers": true,
"normalized_sections": false,
"reviewed_at": "2011-03-28T17:36:19Z",
"priority": 1,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1804|1",
"scorebig_id": null,
"seatgeek_id": 1195,
"stubhub_id": 62,
"ticketcity_id": 1182,
"ticketnetwork_id": 539,
"ticketsnow_id": 1265,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"ignore_from_duplicate_events": false,
"deleted_at": null,
"freeze_name": null,
"disabled_at": null,
"popularity_score": "0.919405",
"search_terms": "'24':6 'att':1C 'ca':3 'francisco':5 'may':8 'park':2C 'plaza':9 'san':4 'us':10 'willi':7",
"slug": "at-t-park",
"ticketmaster_frontend_id": null
}
},
"state": "shown",
"performances": [{
"performer": {
"performer": {
"id": 15556,
"venue_id": 110,
"name": "Arizona Diamondbacks",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:08:46Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1573|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 701,
"ticketcity_id": 325,
"ticketnetwork_id": 58,
"ticketsnow_id": 41,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 30,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.643222",
"search_terms": "'arizona':1C 'diamondback':2C",
"slug": "arizona-diamondbacks",
"ticketmaster_frontend_id": null
}
},
"primary": false
}, {
"performer": {
"performer": {
"id": 15560,
"venue_id": 1172,
"name": "San Francisco Giants",
"keywords": "",
"created_at": "2010-07-30T17:56:09Z",
"updated_at": "2014-05-08T13:06:26Z",
"category_id": 3,
"ebay_id": null,
"empiretickets_id": null,
"goldstar_id": null,
"razorgator_id": "1216|1",
"scorebig_id": null,
"seatgeek_id": null,
"stubhub_id": 197,
"ticketcity_id": 1719,
"ticketnetwork_id": 902,
"ticketsnow_id": 759,
"viagogo_id": null,
"vividseats_id": null,
"seatgeek_frontend_id": 22,
"deleted_at": null,
"disabled_at": null,
"popularity_score": "0.808117",
"search_terms": "'francisco':2C 'giant':3C 'san':1C",
"slug": "san-francisco-giants",
"ticketmaster_frontend_id": null
}
},
"primary": true
}],
"products_count": 1749,
"_type": "Event",
"_score": 1.5511035
}]
} |
Performer Landing Page
Each performer should have their own “landing page” which includes information about that performer and shows any upcoming Events for that performer. Because the Ticket Evolution catalog includes over 45000 Performers, these pages are dynamically created and usually use the slug
property of the Performer to create the URL. In the case of the Arizona Diamondbacks the slug
is arizona-diamondbacks
and your URL might look something like www.myawesometicketsite.com/arizona-diamondbacks-tickets
To generate such a page you should retrieve the Performer slug
from the URL, which in the example of www.myawesometicketsite.com/arizona-diamondbacks-tickets would be arizona-diamondbacks
. Then two API requests are made, the first one being Performers / Show in order to retrieve information about the performer.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
curl -i \
-X GET \
-H "X-Signature: Eha/EE1EbP8mYqmf72AYOq0ee641Y/Q6EoRgDGv1+zM=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/performers/arizona-diamondbacks?' |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
$response = $client->showPerformer([
'performer_id' => 'arizona-diamondbacks',
]);
|
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
@performer = @connection.performers.show('arizona-diamondbacks')
|
Code Block | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"id": 15556,
"name": "Arizona Diamondbacks",
"keywords": "",
"popularity_score": "0.643222",
"url": "/performers/15556",
"slug_url": "/performers/arizona-diamondbacks",
"updated_at": "2014-05-08T13:08:46Z",
"upcoming_events": {
"first": "2017-06-18T13:35:00Z",
"last": "2017-10-01T14:15:00Z"
},
"meta": {
"meta_description": null,
"meta_keywords": null,
"nofollow": false,
"noindex": false,
"canonical_url": null,
"page_title": null,
"header_title": null,
"paragraph_1": null,
"paragraph_2": null,
"paragraph_3": null,
"image": "/images/original/missing.png"
},
"slug": "arizona-diamondbacks",
"venue": {
"id": 110,
"slug": "chase-field",
"name": "Chase Field",
"url": "/venue/110",
"slug_url": "/venue/chase-field",
"updated_at": "2014-05-08T13:11:31Z",
"address": {
"street_address": "401 East Jefferson Street",
"extended_address": null,
"locality": "Phoenix",
"region": "AZ",
"postal_code": "85004",
"country_code": "US",
"created_at": "2012-04-12T03:35:30Z"
}
},
"category": {
"id": "3",
"name": "MLB",
"slug": "mlb",
"url": "/categories/3",
"slug_url": "/categories/mlb",
"parent": {
"id": "2",
"name": "Baseball",
"slug": "baseball",
"url": "/categories/2",
"slug_url": "/categories/baseball",
"parent": {
"id": "1",
"name": "Sports",
"slug": "sports",
"url": "/categories/1",
"slug_url": "/categories/sports",
"parent": null
}
}
},
"opponents": [],
"venues": []
} |
After making the Performer / Show API request the id
of the Performer (15556 in this example) can be used to display upcoming Events using the Events / Index endpoint.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
curl -i \
-X GET \
-H "X-Signature: oy8oDMMfSjCoz6R3oWsE5/2CsKYlypgnHbL9YtDLUAo=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/events?page=1&per_page=2&performer_id=15556' |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
$response = $client->listEvents([
'performer_id' => (int)15556,
]);
|
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
@event = @connection.events.list({
'performer_id' => 15556
})
|
Code Block | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"current_page": 1,
"per_page": 2,
"total_entries": 93,
"events": [{
"id": 1075927,
"url": "/events/1075927",
"name": "Arizona Diamondbacks at Philadelphia Phillies",
"state": "shown",
"occurs_at": "2017-06-18T13:35:00Z",
"occurs_at_local": "2017-06-18T13:35:00-04:00",
"updated_at": "2017-06-18T12:00:33Z",
"notes": null,
"owned_by_office": false,
"products_count": 0,
"products_eticket_count": 0,
"available_count": 42,
"category": {
"id": "3",
"name": "MLB",
"slug": "mlb",
"url": "/categories/3",
"slug_url": "/categories/mlb",
"parent": {
"id": "2",
"name": "Baseball",
"slug": "baseball",
"url": "/categories/2",
"slug_url": "/categories/baseball",
"parent": {
"id": "1",
"name": "Sports",
"slug": "sports",
"url": "/categories/1",
"slug_url": "/categories/sports",
"parent": null
}
}
},
"popularity_score": 1475.87,
"long_term_popularity_score": 0.691195,
"stubhub_id": "9714868",
"configuration": {
"id": 2841,
"url": "/configurations/2841",
"name": "Baseball",
"fanvenues_key": "6575",
"ticket_utils_id": null,
"seating_chart": {
"medium": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/2841/medium.jpg?1429172102",
"large": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/2841/large.jpg?1429172102"
}
},
"venue": {
"id": 2877,
"slug": "citizens-bank-park",
"url": "/venues/2877",
"slug_url": "/venues/citizens-bank-park",
"name": "Citizens Bank Park",
"location": "Philadelphia, PA",
"time_zone": "America/New_York"
},
"performances": [{
"performer": {
"id": 15556,
"slug": "arizona-diamondbacks",
"slug_url": "/performers/arizona-diamondbacks",
"url": "/performers/15556",
"name": "Arizona Diamondbacks"
},
"primary": false
}, {
"performer": {
"id": 15548,
"slug": "philadelphia-phillies",
"slug_url": "/performers/philadelphia-phillies",
"url": "/performers/15548",
"name": "Philadelphia Phillies"
},
"primary": true
}]
}, {
"id": 1076486,
"url": "/events/1076486",
"name": "Arizona Diamondbacks at Colorado Rockies",
"state": "shown",
"occurs_at": "2017-06-20T18:40:00Z",
"occurs_at_local": "2017-06-20T18:40:00-06:00",
"updated_at": "2017-06-18T12:00:46Z",
"notes": null,
"owned_by_office": false,
"products_count": 213,
"products_eticket_count": 213,
"available_count": 576,
"category": {
"id": "3",
"name": "MLB",
"slug": "mlb",
"url": "/categories/3",
"slug_url": "/categories/mlb",
"parent": {
"id": "2",
"name": "Baseball",
"slug": "baseball",
"url": "/categories/2",
"slug_url": "/categories/baseball",
"parent": {
"id": "1",
"name": "Sports",
"slug": "sports",
"url": "/categories/1",
"slug_url": "/categories/sports",
"parent": null
}
}
},
"popularity_score": 512.54,
"long_term_popularity_score": 0.665749,
"stubhub_id": "9715688",
"configuration": {
"id": 2962,
"url": "/configurations/2962",
"name": "Baseball",
"fanvenues_key": "6620",
"ticket_utils_id": null,
"seating_chart": {
"medium": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/2962/medium.jpg?1428732835",
"large": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/2962/large.jpg?1428732835"
}
},
"venue": {
"id": 339,
"slug": "coors-field",
"url": "/venues/339",
"slug_url": "/venues/coors-field",
"name": "Coors Field",
"location": "Denver, CO",
"time_zone": "America/Denver"
},
"performances": [{
"performer": {
"id": 15556,
"slug": "arizona-diamondbacks",
"slug_url": "/performers/arizona-diamondbacks",
"url": "/performers/15556",
"name": "Arizona Diamondbacks"
},
"primary": false
}, {
"performer": {
"id": 15557,
"slug": "colorado-rockies",
"slug_url": "/performers/colorado-rockies",
"url": "/performers/15557",
"name": "Colorado Rockies"
},
"primary": true
}]
}]
} |
Venue Landing Page
Many sites also choose to build a landing page for each venue (there are over 13,000 venues available via our API).
These pages are generated very similarly to the Performer Landing Pages using the Venue slug
from the URL, which in the example of www.myawesometicketsite.com/venues/chase-field-tickets would be chase-field
. Then two API requests are made, the first one being Venues / Show in order to retrieve information about the performer.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
curl -i \
-X GET \
-H "X-Signature: Vmv9v4xDs/0QRNqLWmhT5sjqeoF08Kcxrjcbs9tvP6M=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/venues/chase-field?' |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
$response = $client->showVenue([
'venue_id' => 'chase-field',
]);
|
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
@venue = @connection.venues.show('chase-field')
|
Code Block | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"id": 110,
"name": "Chase Field",
"keywords": "",
"popularity_score": "0.734308",
"url": "/venues/110",
"slug_url": "/venues/chase-field",
"location": "Phoenix, AZ",
"country_code": "US",
"updated_at": "2014-05-08T13:11:31Z",
"address": {
"street_address": "401 East Jefferson Street",
"extended_address": null,
"locality": "Phoenix",
"region": "AZ",
"postal_code": "85004",
"country_code": "US",
"location": "Phoenix, AZ",
"latitude": 33.4528292,
"longitude": -112.0685027,
"label": null,
"created_at": "2012-04-12T03:35:30Z"
},
"upcoming_events": {
"first": "2017-06-23T18:40:00Z",
"last": "2018-01-01T00:00:00Z"
},
"slug": "chase-field",
"meta": {
"meta_description": null,
"meta_keywords": null,
"nofollow": false,
"noindex": false,
"canonical_url": null,
"page_title": null,
"header_title": null,
"paragraph_1": null,
"paragraph_2": null,
"paragraph_3": null,
"image": "/images/original/missing.png"
}
} |
After making the Venues / Show API request the id
of the Venue (110 in this example) can be used to display upcoming Events using the Events / Index endpoint.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
curl -i \
-X GET \
-H "X-Signature: D/OPdqD6qrr1O5nLmvYNArnn9MxyuhDZQh8wf8Ho9Qk=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/events?page=1&per_page=2&venue_id=110' |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
$response = $client->listEvents([
'venue_id' => (int)110,
]);
|
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
@event = @connection.events.list({
'venue_id' => 110
})
|
Code Block | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"current_page": 1,
"per_page": 2,
"total_entries": 47,
"events": [{
"id": 1074303,
"url": "/events/1074303",
"name": "Philadelphia Phillies at Arizona Diamondbacks",
"state": "shown",
"occurs_at": "2017-06-23T18:40:00Z",
"occurs_at_local": "2017-06-23T18:40:00-07:00",
"updated_at": "2017-06-18T12:01:10Z",
"notes": null,
"owned_by_office": false,
"products_count": 103,
"products_eticket_count": 103,
"available_count": 630,
"category": {
"id": "3",
"name": "MLB",
"slug": "mlb",
"url": "/categories/3",
"slug_url": "/categories/mlb",
"parent": {
"id": "2",
"name": "Baseball",
"slug": "baseball",
"url": "/categories/2",
"slug_url": "/categories/baseball",
"parent": {
"id": "1",
"name": "Sports",
"slug": "sports",
"url": "/categories/1",
"slug_url": "/categories/sports",
"parent": null
}
}
},
"popularity_score": 326.24,
"long_term_popularity_score": 0.669116,
"stubhub_id": "9718417",
"configuration": {
"id": 75,
"url": "/configurations/75",
"name": "Baseball",
"fanvenues_key": "6615",
"ticket_utils_id": null,
"seating_chart": {
"medium": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/75/medium.jpg?1428386866",
"large": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/75/large.jpg?1428386866"
}
},
"venue": {
"id": 110,
"slug": "chase-field",
"url": "/venues/110",
"slug_url": "/venues/chase-field",
"name": "Chase Field",
"location": "Phoenix, AZ",
"time_zone": "America/Phoenix"
},
"performances": [{
"performer": {
"id": 15548,
"slug": "philadelphia-phillies",
"slug_url": "/performers/philadelphia-phillies",
"url": "/performers/15548",
"name": "Philadelphia Phillies"
},
"primary": false
}, {
"performer": {
"id": 15556,
"slug": "arizona-diamondbacks",
"slug_url": "/performers/arizona-diamondbacks",
"url": "/performers/15556",
"name": "Arizona Diamondbacks"
},
"primary": true
}]
}, {
"id": 1074357,
"url": "/events/1074357",
"name": "Philadelphia Phillies at Arizona Diamondbacks",
"state": "shown",
"occurs_at": "2017-06-24T19:10:00Z",
"occurs_at_local": "2017-06-24T19:10:00-07:00",
"updated_at": "2017-06-18T12:01:34Z",
"notes": "",
"owned_by_office": false,
"products_count": 87,
"products_eticket_count": 87,
"available_count": 366,
"category": {
"id": "3",
"name": "MLB",
"slug": "mlb",
"url": "/categories/3",
"slug_url": "/categories/mlb",
"parent": {
"id": "2",
"name": "Baseball",
"slug": "baseball",
"url": "/categories/2",
"slug_url": "/categories/baseball",
"parent": {
"id": "1",
"name": "Sports",
"slug": "sports",
"url": "/categories/1",
"slug_url": "/categories/sports",
"parent": null
}
}
},
"popularity_score": 604.95,
"long_term_popularity_score": 0.666638,
"stubhub_id": "9718418",
"configuration": {
"id": 75,
"url": "/configurations/75",
"name": "Baseball",
"fanvenues_key": "6615",
"ticket_utils_id": null,
"seating_chart": {
"medium": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/75/medium.jpg?1428386866",
"large": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/75/large.jpg?1428386866"
}
},
"venue": {
"id": 110,
"slug": "chase-field",
"url": "/venues/110",
"slug_url": "/venues/chase-field",
"name": "Chase Field",
"location": "Phoenix, AZ",
"time_zone": "America/Phoenix"
},
"performances": [{
"performer": {
"id": 15548,
"slug": "philadelphia-phillies",
"slug_url": "/performers/philadelphia-phillies",
"url": "/performers/15548",
"name": "Philadelphia Phillies"
},
"primary": false
}, {
"performer": {
"id": 15556,
"slug": "arizona-diamondbacks",
"slug_url": "/performers/arizona-diamondbacks",
"url": "/performers/15556",
"name": "Arizona Diamondbacks"
},
"primary": true
}]
}]
} |
Event Landing Page
The Event page is where the consumer will select the tickets they wish to purchase. It generally includes a listing of all the available Ticket Groups as well as a seating chart image. Static seating chart images are included with API access and can be retrieved using URLs supplied in the response from the Events / Show endpoint which should be used first to retrieve the information regarding the Event including the Venue at which it occurs, the time (occurs_at
), and the Performers which are scheduled to be at the Event.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
curl -i \
-X GET \
-H "X-Signature: dGlJTI4UBJpZKTMVln/LZqblNM6GHTQahx+omG6lYEk=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/events/1074357?' |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
$response = $client->showEvents([
'event_id' => (int)1074357,
]);
|
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
@event = @connection.events.show(1074357)
|
Code Block | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"id": 1074357,
"url": "/events/1074357",
"name": "Philadelphia Phillies at Arizona Diamondbacks",
"state": "shown",
"occurs_at": "2017-06-24T19:10:00Z",
"occurs_at_local": "2017-06-24T19:10:00-07:00",
"updated_at": "2017-06-18T12:01:34Z",
"notes": "",
"owned_by_office": false,
"products_count": 87,
"products_eticket_count": 87,
"available_count": 366,
"category": {
"id": "3",
"name": "MLB",
"slug": "mlb",
"url": "/categories/3",
"slug_url": "/categories/mlb",
"parent": {
"id": "2",
"name": "Baseball",
"slug": "baseball",
"url": "/categories/2",
"slug_url": "/categories/baseball",
"parent": {
"id": "1",
"name": "Sports",
"slug": "sports",
"url": "/categories/1",
"slug_url": "/categories/sports",
"parent": null
}
}
},
"popularity_score": 604.95,
"long_term_popularity_score": 0.666638,
"stubhub_id": "9718418",
"configuration": {
"id": 75,
"url": "/configurations/75",
"name": "Baseball",
"fanvenues_key": "6615",
"ticket_utils_id": null,
"seating_chart": {
"medium": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/75/medium.jpg?1428386866",
"large": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/75/large.jpg?1428386866"
}
},
"venue": {
"id": 110,
"slug": "chase-field",
"url": "/venues/110",
"slug_url": "/venues/chase-field",
"name": "Chase Field",
"location": "Phoenix, AZ",
"time_zone": "America/Phoenix"
},
"performances": [{
"performer": {
"id": 15548,
"slug": "philadelphia-phillies",
"slug_url": "/performers/philadelphia-phillies",
"url": "/performers/15548",
"name": "Philadelphia Phillies"
},
"primary": false
}, {
"performer": {
"id": 15556,
"slug": "arizona-diamondbacks",
"slug_url": "/performers/arizona-diamondbacks",
"url": "/performers/15556",
"name": "Arizona Diamondbacks"
},
"primary": true
}],
"meta": {
"meta_description": null,
"meta_keywords": null,
"nofollow": false,
"noindex": false,
"canonical_url": null,
"page_title": null,
"header_title": null,
"paragraph_1": null,
"paragraph_2": null,
"paragraph_3": null,
"image": "/images/original/missing.png"
}
} |
After making the Events / Show API request use the Ticket Groups / Index endpoint to display all the available Ticket Groups. You should always use lightweight=true
with the /ticket_groups endpoint.
If you wish to display a static seating chart for the event you can find URLs for medium and large images under venue->configurations→seating_chart (e.g.:
https://s3.amazonaws.com/media.sandbox.ticketevolution.com/configurations/default_maps/ga_1000.jpg)
Info |
---|
In Sandbox you need to change the / |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
curl -i \
-X GET \
-H "X-Signature: aUIDfd+u7mA9xp7iGbY6xIx7ZOGD0Qcb99bDkMKwtgY=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/ticket_groups?event_id=1074357&lightweight=true' |
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
$response = $client->listTicketGroups([
'event_id' => (int)1074357,
'lightweight' => true,
]);
|
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
@ticket_group = @connection.ticket_groups.list({
'event_id' => 1074357,
'lightweight' => true
})
|
Code Block | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"total_entries": 86,
"ticket_groups": [{
"id": 364697812,
"url": "/ticket_groups/364697812",
"type": "parking",
"row": "GA0",
"section": "VALET",
"quantity": 1,
"available_quantity": 1,
"wholesale_price": 12.0,
"eticket": true,
"instant_delivery": false,
"intended_for_instant_delivery": false,
"in_hand": true,
"in_hand_on": null,
"public_notes": "Parking Only",
"splits": [1],
"featured": false,
"retail_price": 12.0,
"format": "Eticket",
"view_type": null,
"broadcast": "t",
"wheelchair": false,
"signature": "RjIvR3BJNEFiQ01iY1BLYnlwdWhzK2tXTnRGS0NYTEZWQzJISXpEM2FyST0tLVEwTzdMMXZDS0h1SEduMzJ6d29ib1E9PQ==--37ffa61344fcad1c5d6acc530c95c352d544481b",
"ticket_states": {
"available": 1
},
"office": {
"id": 1692,
"url": "/offices/1692",
"name": "Auto-Purchase",
"brokerage": {
"id": 1700,
"url": "/brokerages/1700",
"name": "Auto-Purchase",
"abbreviation": "TEvo Seller"
}
}
}, {
"id": 365632437,
"url": "/ticket_groups/365632437",
"type": "event",
"row": "3",
"section": "305",
"quantity": 2,
"available_quantity": 2,
"wholesale_price": 30.24,
"eticket": true,
"instant_delivery": false,
"intended_for_instant_delivery": false,
"in_hand": true,
"in_hand_on": null,
"public_notes": null,
"splits": [2],
"featured": false,
"retail_price": 30.24,
"format": "Eticket",
"view_type": null,
"broadcast": "t",
"wheelchair": false,
"signature": "eExBbnMvc2w1OFVOc1o4Sjd6U0JoeTVlUU44MTF2alg5S0JBcnBrQWRwOD0tLXY0SlNIVzZ5STNXaTYyUXdKNCtyN1E9PQ==--1dd906d2e3cacb4f325876018fd3c4cfaae1445c",
"ticket_states": {
"available": 2
},
"office": {
"id": 1692,
"url": "/offices/1692",
"name": "Auto-Purchase",
"brokerage": {
"id": 1700,
"url": "/brokerages/1700",
"name": "Auto-Purchase",
"abbreviation": "TEvo Seller"
}
}
}
/** TRUNCATED **/
]
} |
Ticket Group Properties
id
type
event
or parking
to indicate which type of ticket this is. parking
tickets do not include admission to the event but are great add-on item to suggest to a visitor purchasing event
ticketssection
Indicates where seats are located.
Tickets without assigned locations are usually labeled as "GA or "General Admission" or "Gen Adm".
Tickets that have no actual seat are usually labeled as "SRO" or "Standing Room Only"
row
available_quantity
splits
<select>
element for the user to choose the quantity they wish to buy you should populate the <option>
s with these values.wholesale_price
discount
parameter when placing your order.retail_price
wholesale_price
with any inventory rules applied. you are not required to charge your customer this amount. If you wish to handle retail price calculation on your side you may.expected_delivery_type
format
Paperless
, GuestList
, FlashSeats
, TMMobile
, Flash_seats
, Guest_list
, Tm_mobile
. After July 2017 you should use format_new
instead.format_revised
Indicator of the format of the ticket. format_revised
supersedes format
after October 2017.
If there are certain types of formats or expected_delivery_types
that you do not wish to sell you may filter them out when displaying Ticket Groups.
format_new | allowed expected_delivery_type s | Details |
---|---|---|
PHYSICAL | FedEx ( | The traditional paper or “hard” ticket that has existed for dozens of years. Physical tickets usually include a barcode that must be scanned in order to gain entry to the event. |
LOCAL_PICKUP | Physical tickets are generally shipped via FedEx, but in some cases may need to be picked up by the consumer at the venue’s Will Call or a location near the venue. The seller will provide the exact location after the order is accepted. | |
|
| These tickets are generally PDF files that the consumer will download and print out to take to the event and generally include a barcode that must be scanned in order to gain entry to the event. |
TM_MOBILE_ENTRY |
| Mobile Entry is rapidly becoming the most prolific way tickets are distributed. The tickets purchased will be transferred to the consumer's email address. The consumer must then accept the transfer and then be prepared to show the tickets on their mobile device in order to gain entry to the event. Learn more from Ticketmaster. |
| Sometimes the seller will provide a PDF of the mobile entry ticket images. These must be displayed on a mobile phone so the barcodes can be scanned for entry. The venue will not allow entry if these are printed on paper. | |
FLASH_SEATS |
| Flash Seats is very similar to TM Mobile Entry. Learn more from Flash Seats. |
CREDIT_CARD_ENTRY | FedEx ( | For some events, no actual tickets are issued and instead the credit card that originally purchased the tickets must be scanned in order to gain entry to the event. Learn more from Ticketmaster. In most cases a gift card with instructions will be sent to the consumer via FedEx and the consumer will use that gift card to gain entry to the event. The gift card does not need to be returned after the event and may be discarded. |
| In some cases it may be too late to ship the gift card required for entry and the Client may need to be picked up by the consumer at the venue’s Will Call or a location near the venue. The seller will provide the exact location after the order is accepted. | |
WALK_IN | In other cases the consumer may need to meet a representative of the company selling the tickets at the venue and the representative will walk the consumer through the process of entering the event. | |
GUEST_LIST | GUEST_LIST | The very rarely used GUEST_LIST is used for exclusive parties such as some Super Bowl parties. The Client’s name(s) will be added to a guest list and the consumer must show a government issued photo ID in order to gain entry to the event. |
in_hand
and in_hand_date
in_hand
is a boolean property that indicates if the Seller has the tickets in their possession and can initiate the delivery process now. Since many sports teams announce their schedules before they deliver tickets to their season ticket holders the Sellers may have purchased the tickets but not yet received them from the team. Similarly, tickets for some other events may be sold but not yet delivered.
If in_hand
is false
then in_hand_date
will be the date on which the Seller expects to be able to initiate the delivery process.
instant_delivery
expected_delivery_type
of FILE_DOWNLOAD
can be Instant Delivery.public_notes
featured
wheelchair
view_type
Full
, Obstructed
, Possibly Obstructed
, or Partially Obstructed
Properties not listed in the table above can be safely ignored.
Creating An Order
Once your customer has selected a ticket group to purchase you can move on to HOWTO: Create Orders Using The API.Next: yyy