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" venue request so you can populate the relevant information on each page.

Search
GET  /venues/search

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

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

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

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