07. Venue Landing Pages

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.

/venues/chase-field using cURL

curl -i \
-X GET \
-H "X-Signature: Vmv9v4xDs/0QRNqLWmhT5sjqeoF08Kcxrjcbs9tvP6M=" \
-H "X-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
--url 'https://api.ticketevolution.com/v9/venues/chase-field?'

/venues/chase-field using ticketevolution-php

$response = $client->showVenue([
    'venue_id' => 'chase-field',
]);

/venues/chase-field using ticketevolution-ruby

@venue = @connection.venues.show('chase-field')

/venues/chase-field JSON response

{
    "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.

/events using cURL

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'

/events using ticketevolution-php

$response = $client->listEvents([
    'venue_id' => (int)110,
]);

/events using ticketevolution-php

@event = @connection.events.list({
    'venue_id' => 110
})

/events JSON response

{
    "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
        }]
    }]
}

Previous: Performer Landing Pages

Next: Event Landing Pages