Welcome, Guest Sign In | Sign Up | Help
Upcoming API Documentation
Currently, the use of these APIs are restricted to non-commercial use only. If you'd like to use it for commercial purposes, please contact us first.
venue.getList [HTTP GET]
Retrieve a list of venues for a particular metro.
Arguments
api_key (Required)
Your API application key. If you don't have one, create one.

metro_id (Required)
The metro_id number of the metro to look within. To find metro_id's, use metro.getList.

token (Optional)
An authentication token. Pass to return private venues. (What's this?)

Response Notes

Within the response, several geographical parameters have been added that refer to the geolocation of the underlying venue of the event. These include latitude and longitude, as well as geocoding_precision, which specifies the precision to which the venue address could be found and geocoded, and also the geocoding_ambiguous parameter, which serves as a warning that the geocoding is likely to be erroneous.

Any venue that could not be geocoded at all will have blank values in the fields.

Example Response

XML

<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
	<venue 	id="2047" name="14 Below" city="Santa Monica" url="http://www.14below.com" 
			user_id="2756" private="0" 
			latitude="37.9183" longitude="-122.024" geocoding_precision="zip" 
			geocoding_ambiguous="0"/>
	<venue 	id="993" name="1650" city="Los Angeles" url="" user_id="2756" private="0" 
			latitude="37.9183" longitude="-122.024" geocoding_precision="zip" 
			geocoding_ambiguous="0"/>
	<venue 	id="754" name="33 1/3 Books and Gallery" city="Los Angeles"
			url="http://www.echoparkfilmcenter.org/" user_id="1" private="0" 
			latitude="37.9183" longitude="-122.024" geocoding_precision="zip" 
			geocoding_ambiguous="0"/>
	<venue 	id="3027" name="5th and Sunset" city="Los Angeles" url="" user_id="845" 
			private="0" 
			latitude="37.9183" longitude="-122.024" geocoding_precision="zip" 
			geocoding_ambiguous="0"/>
	...
</rsp>		

JSON

{
  "rsp":{
    "stat":"ok",
    "version":1,
    "venue":[
		    {
		      "id":31219,
		      "name":"My Dog Votes Candlelight Vigil In Fall River, MA",
		      "city":"Fall River",
		      "url":"",
		      "user_id":33903,
		      "private":0,
		      "latitude":41.6921,
		      "longitude":-71.1315,
		      "geocoding_precision":"Zip code or postal code",
		      "geocoding_ambiguous":0,
		      "address":"City Hall",
		      "zip":2723,
		      "phone":"",
		      "state_name":"Massachusetts",
		      "state_code":"ma",
		      "state_id":22,
		      "country_name":"United States",
		      "country_code":"us",
		      "country_id":1
		    },
		    {
		      "id":31359,
		      "name":"Narrows Center for the Arts",
		      "city":"Fall River",
		      "url":"",
		      "user_id":18326,
		      "private":0,
		      "latitude":41.7031,
		      "longitude":-71.1634,
		      "geocoding_precision":"Zip code or postal code",
		      "geocoding_ambiguous":0,
		      "address":"16 Anawan St.",
		      "zip":2721,
		      "phone":"",
		      "state_name":"Massachusetts",
		      "state_code":"ma",
		      "state_id":22,
		      "country_name":"United States",
		      "country_code":"us",
		      "country_id":1
		    },
		    {
		      "id":17337,
		      "name":"Narrows Center or the Arts",
		      "city":"Fall River",
		      "url":"",
		      "user_id":15305,
		      "private":0,
		      "latitude":41.7031,
		      "longitude":-71.1634,
		      "geocoding_precision":"Zip code or postal code",
		      "geocoding_ambiguous":0,
		      "address":"16 Anawan St.",
		      "zip":2721,
		      "phone":"",
		      "state_name":"Massachusetts",
		      "state_code":"ma",
		      "state_id":22,
		      "country_name":"United States",
		      "country_code":"us",
		      "country_id":1
		    },
		    {
		      "id":47007,
		      "name":"P.A.L - Police Athletic League",
		      "city":"Fall River",
		      "url":"",
		      "user_id":105942,
		      "private":0,
		      "latitude":41.7033,
		      "longitude":-71.1545,
		      "geocoding_precision":"Zip code or postal code",
		      "geocoding_ambiguous":0,
		      "address":"31 Franklin Street",
		      "zip":"MA",
		      "phone":"508-672-9197",
		      "state_name":"Massachusetts",
		      "state_code":"ma",
		      "state_id":22,
		      "country_name":"United States",
		      "country_code":"us",
		      "country_id":1
		    },
		    {
		      "id":174960,
		      "name":"The Narrows Center for the Arts",
		      "city":"Fall River",
		      "url":"",
		      "user_id":18326,
		      "private":0,
		      "latitude":41.7031,
		      "longitude":-71.1634,
		      "geocoding_precision":"Zip code or postal code",
		      "geocoding_ambiguous":0,
		      "address":"16 Anawan Street",
		      "zip":2721,
		      "phone":"",
		      "state_name":"Massachusetts",
		      "state_code":"ma",
		      "state_id":22,
		      "country_name":"United States",
		      "country_code":"US",
		      "country_id":1
		    },
		    {
		      "id":44863,
		      "name":"Waterstreet Cafe",
		      "city":"Fall River",
		      "url":"http:\/\/www.waterstreetcafe.com",
		      "user_id":103237,
		      "private":0,
		      "latitude":41.7043,
		      "longitude":-71.1628,
		      "geocoding_precision":"Zip code or postal code",
		      "geocoding_ambiguous":0,
		      "address":"36 Water Street",
		      "zip":2720,
		      "phone":"508-672-8748",
		      "state_name":"Massachusetts",
		      "state_code":"ma",
		      "state_id":22,
		      "country_name":"United States",
		      "country_code":"us",
		      "country_id":1
		    }
      ]
  }
}
	  
Error Code (sent in HTTP Response Header)
403 Not Authorized:
  • Invalid authentication parameters - either that token was not found, or it may be deactivated. Please contact us for support.

404 Not Found:
  • Missing valid api_key - Please create an API key using the above link.
  • Your api_key is inactive or not found - Please contact us for support.
  • Missing valid metro_id parameter - Your metro_id may be improperly formatted or non-numeric. Only numeric metro_id's are allowed.
Tools
Upcoming Badges for Your Blog/Website | Invite Friends | Groups | Developers API
Help
News Blog | Community Guidelines | FAQ | Contact Us | Suggestion Board | About Us