Gets all events in the watchlist for a user. You may optionally pass authentication parameters for this function to get back private events from people who have authenticated user as a friend. The 'username' returned is the username of the watchlist owner. It also returns either status="attend" or status="watch". Watchlists for personal events that are created by friends of the user authenticated are shown.
In other words, you pass a username and password. Naturally, you'll have access to see any events created by others who have you as a friend. If the user_id you query has any of those specific personal events as an item in their watchlist, they will show up in this function.
Additionally, by default, user.getWatchlist only returns events with a start date >= today, or upcoming events. To get all events ever in a user's watchlist, or to get past events only, pass the "show" parameter.
api_key (Required)
Your API application key. If you don't have one,
create one.
token (Optional)
An authentication token. (
What's this?)
user_id (Required)
The user_id requested.
show (Optional, Default: 'upcoming')
May be 'upcoming', 'all', or 'past' to retrieve corresponding events.
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..
<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
<event username="getluky" status="watch" id="14535"
name="Ulrich Schnauss" tags="ambient,german"
description="Ulrich Schnauss +Special Guests"
start_date="2005-04-29" end_date="0000-00-00"
start_time="20:00:00" end_time=""
personal="0" metro_id="1" venue_id="4136"
user_id="10541" category_id="1"
latitude="37.765" longitude="-122.396"
geocoding_precision="address" geocoding_ambiguous="0"
venue_address="747 Howard Street" venue_city="San Francisco"
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="94103" venue_url="http://www.moscone.com/"
venue_phone="(415) 974-4000" />
<event username="getluky" status="attend" id="16314"
name="Napoleon Dynamite (2004)" tags="cinema"
description="A film with deadpan skills, awkwardness
skills and maybe a few Wes Anderson skills makes
it quickly to the midnight slot at the Nuart.
Tickets are $10 or so." start_date="2005-05-06"
end_date="0000-00-00" start_time="23:55:00"
end_time="" personal="0" metro_id="1"
venue_id="16" user_id="12" category_id="3"
latitude="37.765" longitude="-122.396"
geocoding_precision="address" geocoding_ambiguous="0"
venue_name="Nuart Theater" venue_address="11272 Santa Monica Boulevard"
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="90025"
venue_url="http://www.landmarktheatres.co" venue_phone="310 281 8223" />
</rsp>