Retrieve event information and metadata for public and private events.
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?)
photo_url
For events with photos attached, we include a photo_url that refers to one of those photos. This is the priority order
for selecting which photo goes into the photo_url field:
- The photo marked as "official" by the person who added the event.
- The photo of a performer, if the person who added the event tagged it with a Y! Music performer.
- Any randomly selected photo uploaded directly to Upcoming.
- Any randomly selected photo from Flickr tagged to this event.
Official and Upcoming-hosted photos are 75x75px. Y! Music performer photos are 80x80px. Flickr photos vary but have a max height/width of 100px.
geographical fields
Within the response, several geographical fields 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. The geocoding_ambiguous parameter serves as a warning that the geocoding is
likely to be erroneous.
<?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 "Lottapianos" 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"
photo_url="http://l.yimg.com/dt/000/003/485/348.jpg"
ticket_url="http://www.ticketweb.com" ticket_price="$10.00" ticket_free="0"
/>
</rsp>
{ "rsp" : { "event" : [ { "category_id" : 1,
"date_posted" : "2003-06-07",
"description" : "The "Lottapianos" Tour. Ben Folds is opening, and will play a one hour set.",
"end_date" : "",
"end_time" : "",
"geocoding_ambiguous" : "",
"geocoding_precision" : "",
"id" : 1,
"latitude" : "",
"longitude" : "",
"metro_id" : 1,
"name" : "Tori Amos, Ben Folds",
"personal" : 0,
"photo_url" : "",
"selfpromotion" : 0,
"start_date" : "2003-08-01",
"start_time" : "19:00:00",
"tags" : "",
"ticket_free" : 0,
"ticket_price" : "",
"ticket_url" : "",
"url" : "",
"user_id" : 1,
"utc_end" : "2003-08-02 05:00:00 UTC",
"utc_start" : "2003-08-02 02:00:00 UTC",
"venue_address" : "2700 North Vermont",
"venue_city" : "Los Angeles",
"venue_country_code" : "us",
"venue_country_id" : 1,
"venue_country_name" : "United States",
"venue_id" : 1,
"venue_name" : "Greek Theatre",
"venue_phone" : "(323) 665-5857",
"venue_state_code" : "ca",
"venue_state_id" : 5,
"venue_state_name" : "California",
"venue_url" : "http://www.greektheatrela.com/",
"venue_zip" : 90027
} ],
"stat" : "ok",
"version" : 1
}
}