05. Displaying Events Near Your Users
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.
Upcoming Events within 20 miles of Las Vegas via cURL
curl -i \
-X GET \
-H "X-Signature: pPCFj3WtbPLOxu3aZCsh1PieUb72qUQsNSi9Wn6Gcbk=" \
-H "X-Token: 11cdfc2ed4cd788b932cd4b542e6c2b7" \
--url 'https://api.sandbox.ticketevolution.com/v9/events?lat=36.1207804&lon=-115.156559&order_by=events.occurs_at&page=1&per_page=3&within=20'
Events within 20 miles of Las Vegas using ticketevolution-php
$response = $client->listEvents([
'page => 1,
'per_page => 10,
'lat => 36.1207804,
'lon => -115.156559,
'within => 20,
'order_by' => 'events.occurs_at',
]));
Upcoming Events within 20 miles of Las Vegas via cURL
{
"current_page": 1,
"per_page": 3,
"total_entries": 2166,
"events": [
{
"id": 1142891,
"url": "/events/1142891",
"name": "Indian Adventure Tour",
"state": "shown",
"occurs_at": "2017-12-18T06:00:00Z",
"occurs_at_local": "2017-12-18T06:00:00-08:00",
"updated_at": "2017-03-14T21:33:26Z",
"notes": "",
"owned_by_office": false,
"products_count": 0,
"products_eticket_count": 0,
"available_count": 26,
"category": null,
"popularity_score": 0,
"long_term_popularity_score": 0,
"stubhub_id": null,
"configuration": {
"id": 31748,
"url": "/configurations/31748",
"name": "General Admission",
"fanvenues_key": null,
"ticket_utils_id": null,
"seating_chart": {
"medium": "https://s3.amazonaws.com/media.sandbox.ticketevolution.com/configurations/default_maps/ga_500.jpg",
"large": "https://s3.amazonaws.com/media.sandbox.ticketevolution.com/configurations/default_maps/ga_1000.jpg"
}
},
"venue": {
"id": 29841,
"slug": "las-vegas-attractions",
"url": "/venues/29841",
"slug_url": "/venues/las-vegas-attractions",
"name": "Las Vegas Attractions",
"location": "Las Vegas, NV",
"time_zone": null
},
"performances": [
{
"performer": {
"id": 51497,
"slug": "indian-country-adventure-tour",
"slug_url": "/performers/indian-country-adventure-tour",
"url": "/performers/51497",
"name": "Indian Adventure Tour"
},
"primary": true
}
]
},
{
"id": 1204787,
"url": "/events/1204787",
"name": "Grand Canyon Deluxe Tour",
"state": "shown",
"occurs_at": "2017-12-18T06:15:00Z",
"occurs_at_local": "2017-12-18T06:15:00-08:00",
"updated_at": "2017-04-02T14:47:55Z",
"notes": "",
"owned_by_office": false,
"products_count": 0,
"products_eticket_count": 0,
"available_count": 24,
"category": null,
"popularity_score": 0,
"long_term_popularity_score": 0,
"stubhub_id": null,
"configuration": {
"id": 31748,
"url": "/configurations/31748",
"name": "General Admission",
"fanvenues_key": null,
"ticket_utils_id": null,
"seating_chart": {
"medium": "https://s3.amazonaws.com/media.sandbox.ticketevolution.com/configurations/default_maps/ga_500.jpg",
"large": "https://s3.amazonaws.com/media.sandbox.ticketevolution.com/configurations/default_maps/ga_1000.jpg"
}
},
"venue": {
"id": 29841,
"slug": "las-vegas-attractions",
"url": "/venues/29841",
"slug_url": "/venues/las-vegas-attractions",
"name": "Las Vegas Attractions",
"location": "Las Vegas, NV",
"time_zone": null
},
"performances": [
{
"performer": {
"id": 52610,
"slug": "grand-canyon-deluxe-tour",
"slug_url": "/performers/grand-canyon-deluxe-tour",
"url": "/performers/52610",
"name": "Grand Canyon Deluxe Tour"
},
"primary": true
}
]
},
{
"id": 1161405,
"url": "/events/1161405",
"name": "Grand Canyon Explorer and Eldorado Adventure",
"state": "shown",
"occurs_at": "2017-12-18T06:30:00Z",
"occurs_at_local": "2017-12-18T06:30:00-08:00",
"updated_at": "2017-01-16T00:14:19Z",
"notes": "",
"owned_by_office": false,
"products_count": 0,
"products_eticket_count": 0,
"available_count": 12,
"category": null,
"popularity_score": 0,
"long_term_popularity_score": 0,
"stubhub_id": null,
"configuration": {
"id": 31748,
"url": "/configurations/31748",
"name": "General Admission",
"fanvenues_key": null,
"ticket_utils_id": null,
"seating_chart": {
"medium": "https://s3.amazonaws.com/media.sandbox.ticketevolution.com/configurations/default_maps/ga_500.jpg",
"large": "https://s3.amazonaws.com/media.sandbox.ticketevolution.com/configurations/default_maps/ga_1000.jpg"
}
},
"venue": {
"id": 29841,
"slug": "las-vegas-attractions",
"url": "/venues/29841",
"slug_url": "/venues/las-vegas-attractions",
"name": "Las Vegas Attractions",
"location": "Las Vegas, NV",
"time_zone": null
},
"performances": [
{
"performer": {
"id": 50664,
"slug": "grand-canyon-explorer-and-eldorado-adventure",
"slug_url": "/performers/grand-canyon-explorer-and-eldorado-adventure",
"url": "/performers/50664",
"name": "Grand Canyon Explorer and Eldorado Adventure"
},
"primary": true
}
]
}
]
}
Previous: Comprehensive Search
Next: Performer Landing Pages