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.
event.getInfo [HTTP GET]
Retrieve event information and metadata for public and private events.
Arguments
api_key (Required)
Your API application key. If you don't have one, create one.

event_id (Required)
The id number of the event. You can also pass multiple event_id's separated by commas to getInfo on multiple events.

token (Optional)
An authentication token. Pass to see even private events. (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 event at a 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">
  <event id="1" name="Tori Amos, Ben Folds" 
    tags="music,concert"
    description="The &quot;Lottapianos&quot; Tour.  Ben Folds is opening, and will 
    play a one hour set." 
    start_date="2003-08-01" 
    end_date="0000-00-00" 
    start_time="19:00:00" end_time="" 
    personal="0" selfpromotion="0" 
    metro_id="1" venue_id="1" 
    user_id="1" category_id="1" 
    date_posted="2003-06-07" 
    latitude="37.765" 
    longitude="-122.396" 
    geocoding_precision="address" 
    geocoding_ambiguous="0"
    venue_name="Greek Theatre"
    venue_address="2700 North Vermont"
    venue_city="Los Angeles"
    venue_state_name="California"
    venue_state_code="ca"
    venue_state_id="5"
    venue_country_name="United States"
    venue_country_code="us"
    venue_country_id="1"
    venue_zip="90027"
    venue_url="http://www.greektheatrela.com"
    venue_phone="(323)665-5857"
  />
</rsp>
		
Error Codes (sent in HTTP Response Header)
301 Moved Permanently:
  • The event <Event ID> has been permanently merged to http://upcoming.yahoo.com/event/<Event ID>/ - Please check the new URL to find the event.
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 event_id parameter - Your event_id may be improperly formatted or non-numeric. Only numeric event_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