Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

NameVenues Index
DescriptionList all venues conforming to passed parameters.
TypeGET
URL/v9/venues

Long Description

Obtain a list of venues that match certain conditions.  Events occur at venues, and are directly related.

Parameters

Name
Description
Value Type
Required
nameExact name of the venueStringOptional
popularity_scoreVenue's popularity rating, imported from SeatGeekdecimalOptional
disabled_atDate/time venue was disabledDateOptional
deleted_atDate/time venue was deletedDate

Optional

updated_atDate/time venue was updatedDateOptional
first_letterFilters venues by the first letter passedCharOptional
latLatitude of venue (requires corresponding lon)DecimalOptional
lonLongitude of venue (requires corresponding lat)DecimalOptional
ipInfer lat and lon by location of IP AddressStringOptional
postal_codeInfer lat and lon by location of postal codeStringOptional
city_stateInfer lat and lon by location of city and stateStringOptional
withinRadius from lat and lon to search (default 15)IntegerOptional

Examples

RequestResponse
/v9/venues?lat=40.7281&lon=-74.0781&within=1 

 

{
   "current_page":1,
   "total_entries":2,
   "venues":[
      {
         "upcoming_events":{
            "last":"2013-01-27 14:00:00",
            "first":"2010-12-04 19:00:00"
         },
         "address":{
            "locality":"Jersey City",
            "postal_code":"07306",
            "label":null,
            "country_code":"US",
            "street_address":"Saint Peters College",
            "created_at":"2012-04-12 03:37:53.735782",
            "latitude":"40.7272951338493",
            "extended_address":"Kennedy Boulevard",
            "location":"Jersey City, NJ",
            "longitude":"-74.0707141693115",
            "region":"NJ"
         },
         "popularity_score":"0.000000",
         "keywords":null,
         "country_code":"US",
         "url":"/venues/9114",
         "updated_at":"2012-10-01 18:00:39.221713",
         "location":"Jersey City, NJ",
         "name":"Yanitelli Center",
         "id":9114
      },
      {
         "upcoming_events":{
            "last":"2011-11-06 08:00:00",
            "first":"2011-11-06 08:00:00"
         },
         "address":{
            "locality":"Jersey City",
            "postal_code":"07306",
            "label":null,
            "country_code":"US",
            "street_address":"54 Journal Square",
            "created_at":"2012-04-12 03:37:55.198502",
            "latitude":"40.7320659",
            "extended_address":null,
            "location":"Jersey City, NJ",
            "longitude":"-74.0641019",
            "region":"NJ"
         },
         "popularity_score":"0.000000",
         "keywords":"",
         "country_code":"US",
         "url":"/venues/4586",
         "updated_at":"2012-05-24 15:20:27.697444",
         "location":"Jersey City, NJ",
         "name":"Landmark Loews Jersey Theatre",
         "id":4586
      }
   ],
   "per_page":100
}