Venues Endpoint | Ticket Evolution API Docs

Search
GET /venues/search

Sample Code

/**
 * Setup configuration
 */
$cfg['params']['apiToken'] = (string) '111222333444555666777888999';
$cfg['params']['secretKey'] = (string) 'aaabbbcccdddeeefffggghhhiiijjjkkk';
$cfg['params']['apiVersion'] = (string) '9';
$cfg['params']['buyerId'] = '666';
$cfg['params']['baseUri'] = (string) 'https://api.ticketevolution.com';

$config = new Zend_Config($cfg);

/**
 * Finished setting up configuration.
 * Initialize a TicketEvolution_Webservice object.
 */
$tevo = new TicketEvolution_Webservice($config->params);

/**
 * Below here is where all the method-specific stuff is.
 */
$options = array(
    'page' => 1,
    'per_page' => 2,
);

$results = $tevo->searchVenues('madison Square', $options);

Sample Response

{
                   "venues" => [
                [0] {
                     "upcoming_events" => {
                         "last" => "2013-02-19T08:00:00Z",
                        "first" => "2012-11-12T20:00:00Z"
                    },
                        "country_code" => "US",
                            "keywords" => "msg vs:id=973 sg:id=296",
                          "updated_at" => "2012-04-06T15:30:22Z",
                    "popularity_score" => "0.0",
                                "name" => "Madison Square Garden",
                             "address" => {
                          "street_address" => "4 Pennsylvania Plaza",
                        "extended_address" => nil,
                                "latitude" => nil,
                             "postal_code" => "10001",
                                "locality" => "New York",
                               "longitude" => nil,
                                  "region" => "NY",
                              "created_at" => "2012-04-06T15:30:22Z",
                                   "label" => nil
                    },
                            "location" => "New York, NY",
                                 "url" => "/venues/896",
                                  "id" => 896
                },
                [1] {
                     "upcoming_events" => {
                         "last" => "2012-11-18T19:00:00Z",
                        "first" => "2012-11-18T19:00:00Z"
                    },
                        "country_code" => "US",
                            "keywords" => "ei:id=1697 vs:id=1697 sg:id=636",
                          "updated_at" => "2012-04-06T15:31:52Z",
                    "popularity_score" => "0.0",
                                "name" => "Theater at Madison Square Garden",
                             "address" => {
                          "street_address" => "7th Ave & 32nd Street",
                        "extended_address" => nil,
                                "latitude" => nil,
                             "postal_code" => "10001",
                                "locality" => "New York",
                               "longitude" => nil,
                                  "region" => "NY",
                              "created_at" => "2012-04-06T15:31:52Z",
                                   "label" => nil
                    },
                            "location" => "New York, NY",
                                 "url" => "/venues/1562",
                                  "id" => 1562
                }
            ],
            "total_entries" => 2
}

Parameters

Name	Value	Description
q		Pass in the search terms you would like to search by. This search will also search on our "keywords" which can include a venues previous names or abbreviations like "msg" for Madison Square Garden.
page		Number of pages that you want to return
per_page		Number of results returned per page

List
GET /venues

SEO
The Ticket Evolution API comes with a powerful content management system in order to simplify your SEO efforts. Simply log into the settings app and manage your site content under "Manage Content". This information will be returned via a "show" event request so you can populate the relevant information on each page.

Sample Code

/**
 * Setup configuration
 */
$cfg['params']['apiToken'] = (string) '111222333444555666777888999';
$cfg['params']['secretKey'] = (string) 'aaabbbcccdddeeefffggghhhiiijjjkkk';
$cfg['params']['apiVersion'] = (string) '9';
$cfg['params']['buyerId'] = '666';
$cfg['params']['baseUri'] = (string) 'https://api.ticketevolution.com';

$config = new Zend_Config($cfg);

/**
 * Finished setting up configuration.
 * Initialize a TicketEvolution_Webservice object.
 */
$tevo = new TicketEvolution_Webservice($config->params);

/**
 * Below here is where all the method-specific stuff is.
 */
$options = array(
    'page' => 1,
    'per_page' => 2,
);

$results = $tevo->listVenues($options);

Sample Response

{
                   "venues" => [
                [0] {
                     "upcoming_events" => {
                         "last" => "2012-06-30 19:00:00",
                        "first" => "2012-05-04 19:00:00"
                    },
                        "country_code" => "US",
                            "keywords" => nil,
                          "updated_at" => "2012-04-06 15:35:15.351935",
                    "popularity_score" => "0.000000",
                                "name" => "The Walnut Room",
                             "address" => {
                          "street_address" => "3131 Walnut St.",
                        "extended_address" => nil,
                                "latitude" => nil,
                             "postal_code" => "80205",
                                "locality" => "Denver",
                               "longitude" => nil,
                                  "region" => "CO",
                              "created_at" => "2012-04-06 15:35:15.26618",
                                   "label" => nil
                    },
                            "location" => "Denver, CO",
                                 "url" => "/venues/28206",
                                  "id" => 28206
                },
                [1] {
                     "upcoming_events" => {
                         "last" => "2012-02-04 22:00:00",
                        "first" => "2012-02-01 18:00:00"
                    },
                        "country_code" => "US",
                            "keywords" => nil,
                          "updated_at" => "2012-04-06 15:35:01.729567",
                    "popularity_score" => "0.000000",
                                "name" => "Theatre 99",
                             "address" => {
                          "street_address" => "280 Meeting Street",
                        "extended_address" => nil,
                                "latitude" => nil,
                             "postal_code" => "29413",
                                "locality" => "Charleston",
                               "longitude" => nil,
                                  "region" => "SC",
                              "created_at" => "2012-04-06 15:35:01.686535",
                                   "label" => nil
                    },
                            "location" => "Charleston, SC",
                                 "url" => "/venues/27896",
                                  "id" => 27896
                }
            ],
            "total_entries" => 8262,
             "current_page" => "1",
                 "per_page" => "2"
}

Parameters

Name	Value	Description
city_state		Pass in a city and state to receive venues within 15 miles. e.g.: 'Philadelphia, PA' Use "radius" to override the default miles.
name		Name of venue.
radius		Pass in an integer to override the default radius of 15 miles
postal_code		Pass in a postal code to filter venues within 15 miles of a postal code. Use "radius" to override the default miles.
lat & lon		Pass in latitude and longitude to filter venues within 15 miles of the long/lat Ex. ":lat => 40, :lon => 70". Use "radius" to override the default miles.
first_letter		Filter venues by first_letter
order_by		Pass in the filter that you want to order by and the sorting order (Ex. :order_by => "venues.popularity_score DESC")
IP		Pass in the user's IP address to filter venues within 15 miles of the user's location. Use "radius" to override the default miles.
updated_at		An ISO 8601 date time when the venue was last updated. Use in combination with the conditionals like `.gte` to get updated since.
page		Number of pages that you want to return
per_page		Number of results returned per page

Show
GET /venues/:venue_id

This call will return any SEO elements you have entered into the built in content management system which can be found in the Ticket Evolution Settings App. These details should be used to dynamically populate your page elements like page title, meta description, h1 tag, unique content, etc...

You can also set up default fallback page elements for each page type.

Sample Code

/**
 * Setup configuration
 */
$cfg['params']['apiToken'] = (string) '111222333444555666777888999';
$cfg['params']['secretKey'] = (string) 'aaabbbcccdddeeefffggghhhiiijjjkkk';
$cfg['params']['apiVersion'] = (string) '9';
$cfg['params']['buyerId'] = '666';
$cfg['params']['baseUri'] = (string) 'https://api.ticketevolution.com';

$config = new Zend_Config($cfg);

/**
 * Finished setting up configuration.
 * Initialize a TicketEvolution_Webservice object.
 */
$tevo = new TicketEvolution_Webservice($config->params);

/**
 * Below here is where all the method-specific stuff is.
 */
$results = $tevo->showVenue(5725);

Sample Response

{
                    "keywords" => "ei:id=6135 vs:id=6135 sg:id=2058",
            "popularity_score" => "0.0",
                  "updated_at" => "2012-04-06T15:30:15Z",
                        "meta" => {
                         "noindex" => true,
                "meta_description" => "Buy all Yankee Stadium tickets here at great prices.",
                   "canonical_url" => nil,
                           "image" => "/images/original/missing.png",
                        "nofollow" => true,
                      "page_title" => "Yankee Stadium Tickets on sale here",
                    "header_title" => "Yankee Stadium Tickets",
                   "meta_keywords" => "yankee stadium tickets, new york yankees stadium",
                     "paragraph_3" => nil,
                     "paragraph_2" => nil,
                     "paragraph_1" => "Yankee Stadium is a historical baseball stadium.  Get your tickets to all upcoming Yankee Stadium events here."
            },
                         "url" => "/venues/5725",
                        "name" => "Yankee Stadium",
             "upcoming_events" => {
                 "last" => "2012-10-03T19:05:00Z",
                "first" => "2012-08-28T13:00:00Z"
            },
                     "address" => {
                       "longitude" => nil,
                          "region" => "NY",
                      "created_at" => "2012-04-06T15:30:15Z",
                           "label" => nil,
                  "street_address" => "161st Street and River Avenue",
                "extended_address" => nil,
                        "latitude" => nil,
                     "postal_code" => "10452",
                        "locality" => "Bronx"
            },
                "country_code" => "US",
                    "location" => "Bronx, NY",
                          "id" => 5725
}

Parameters

Name	Value	Description
venue_id

Deleted
GET /venues/deleted

Sample Code

/**
 * Setup configuration
 */
$cfg['params']['apiToken'] = (string) '111222333444555666777888999';
$cfg['params']['secretKey'] = (string) 'aaabbbcccdddeeefffggghhhiiijjjkkk';
$cfg['params']['apiVersion'] = (string) '9';
$cfg['params']['buyerId'] = '666';
$cfg['params']['baseUri'] = (string) 'https://api.ticketevolution.com';

$config = new Zend_Config($cfg);

/**
 * Finished setting up configuration.
 * Initialize a TicketEvolution_Webservice object.
 */
$tevo = new TicketEvolution_Webservice($config->params);

/**
 * Below here is where all the method-specific stuff is.
 */
$options = array(
    'page' => 1,
    'per_page' => 2,
    'deleted_at.gte' => '2011-09-07 20:27:49',
);

$results = $tevo->listVenuesDeleted($options);

Sample Response

{
                   "venues" => [
                [0] {
                     "upcoming_events" => {
                         "last" => nil,
                        "first" => nil
                    },
                        "country_code" => nil,
                            "keywords" => "sg:id=14568",
                          "updated_at" => "2011-09-27 13:46:07.31509",
                    "popularity_score" => nil,
                                "name" => "Lookingglass Theatre",
                             "address" => {
                          "street_address" => "821 N Michigan Ave",
                        "extended_address" => nil,
                                "latitude" => nil,
                             "postal_code" => "60611",
                                "locality" => "Chicago",
                               "longitude" => nil,
                                  "region" => "IL",
                              "created_at" => "2011-09-27 13:46:07.311888",
                                   "label" => nil
                    },
                            "location" => "Chicago, IL",
                                 "url" => "/venues/15115",
                                  "id" => 15115
                },
                [1] {
                     "upcoming_events" => {
                         "last" => nil,
                        "first" => nil
                    },
                        "country_code" => nil,
                            "keywords" => "sg:id=15653",
                          "updated_at" => "2011-09-27 13:48:05.260037",
                    "popularity_score" => nil,
                                "name" => "Boston Opera House",
                             "address" => {
                          "street_address" => "Boston Opera House",
                        "extended_address" => "539 Washington Street",
                                "latitude" => nil,
                             "postal_code" => "02111",
                                "locality" => "Boston",
                               "longitude" => nil,
                                  "region" => "MA",
                              "created_at" => "2011-09-27 13:48:05.256551",
                                   "label" => nil
                    },
                            "location" => "Boston, MA",
                                 "url" => "/venues/15919",
                                  "id" => 15919
                }
            ],
            "total_entries" => 19939,
             "current_page" => "1",
             "per_page" => "2"
}

Parameters

Name	Value	Description
deleted_at		An ISO 8601 date time. Use in combination with the conditionals like `.gte` to get deleted since.
page		Number of pages that you want to return
per_page		Number of results returned per page

Venues

Search GET /venues/search

Sample Code

Sample Response

Parameters

List GET /venues

Sample Code

Sample Response

Parameters

Show GET /venues/:venue_id

Sample Code

Sample Response

Parameters

Deleted GET /venues/deleted

Sample Code

Sample Response

Parameters

Set Auth Credentials

Search
GET /venues/search

List
GET /venues

Show
GET /venues/:venue_id

Deleted
GET /venues/deleted