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..
{
"rsp":{
"stat":"ok",
"version":1,
"event":[
{
"username":"7e9466ad4b2775ee9b886b1bc4743e17",
"status":"watch",
"id":574200,
"name":"Maker Faire",
"tags":"make,craft,makerfaire,oreilly,tinker,invention,innovation",
"description":"Make magazine's and Craft magazine's \"urban Burning Man\" for tinkerers and crafters returns to the Bay Area.\r\n\r\nOfficialesque description:\r\nMaker Faire is a two-day, family-friendly event that celebrates the Do-It-Yourself (DIY) mindset. It\u2019s for creative, resourceful people of all ages and backgrounds who like to tinker and love to make things.",
"start_date":"2009-05-30",
"end_date":"2009-05-31",
"start_time":"",
"end_time":"",
"personal":0,
"metro_id":923,
"venue_id":9408,
"user_id":15305,
"venue_name":"San Mateo Fairgrounds",
"latitude":37.5461,
"longitude":-122.304,
"geocoding_precision":"Zip code or postal code",
"geocoding_ambiguous":0,
"venue_address":"2495 South Delaware Street",
"venue_city":"San Mateo",
"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":94403,
"venue_url":"",
"venue_phone":"",
"ticket_url":"",
"ticket_price":"",
"ticket_free":0
},
{
"username":"7e9466ad4b2775ee9b886b1bc4743e17",
"status":"watch",
"id":1462593,
"name":"Back to the Future 2 Party",
"tags":"",
"description":"Great Scott! Marty goes forward in time to fix things, and makes them worse! Celebrate!",
"start_date":"2015-10-21",
"end_date":"",
"start_time":"16:00:00",
"end_time":"",
"personal":0,
"metro_id":2,
"venue_id":66330,
"user_id":78338,
"venue_name":"Everywhere",
"latitude":37.7791,
"longitude":-122.42,
"geocoding_precision":"Town",
"geocoding_ambiguous":0,
"venue_address":"Everywhere",
"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":"",
"venue_url":"",
"venue_phone":"",
"ticket_url":"",
"ticket_price":"",
"ticket_free":1
}
]
}
}