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.getInfo [HTTP GET]
Retrieve the details about a venue.
Arguments
api_key (Required)
Your API application key. If you don't have one, create one.

venue_id (Required)
The venue_id number of the venue to look within. To find venue_id's, use venue.getList. You can also pass multiple venue_id's separated by commas to getInfo on multiple venues.

token (Optional)
An authentication token. Optional for viewing 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 (i.e. non-US venues) will have blank values in the fields..

Example Response
<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
<venue id="44278" name="the Crypt" address="St. Giles Centre, 81 Camberwell
    Church Street," city="Camberwell" state="London" zip="SE5 8RB" country="United
    Kingdom" url="" description="Lambchop." user_id="101782" metro_id="49" private="0" latitude=""
    longitude="" geocoding_precision="" geocoding_ambiguous="" state_code="lon"
    state_id="59" country_code="uk" country_id="6"/> 
<venue id="9733"
    name="the troubador" address="9081 santa monica boulevard @ doheny drive"
    city="los angeles" state="California" zip="90069" country="United States"
    url="http://www.troubadour.com/" description="small place with a balcony.
    people tell me it is aces and you can punch and kick like an infant up front.
    i've never been so your mileage may vary." user_id="2067" metro_id="1"
    private="0" latitude="34.0919" longitude="-118.381" geocoding_precision="zip"
    geocoding_ambiguous="0" state_code="ca" state_id="5"
    country_code="us" country_id="1"/>
    />
</rsp>		
Error Codes (sent in HTTP Response Header)
301 Moved Permanently:
  • The venue <Event ID> has been permanently merged to http://upcoming.yahoo.com/venue/<Event ID>/ - Please check the new URL to find the venue.
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 venue_id parameter - Your venue_id may be improperly formatted or non-numeric. Only numeric venue_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