API Documentation - user.getMyFriendsEvents

Welcome, Guest Sign In | Sign Up | Help

Upcoming

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.

user.getMyFriendsEvents [HTTP GET]

Retrieve the events being watched/attended by a user's friends. These events can either be public or created by a person who calls the user a friend.

Arguments

api_key (Required)
Your API application key. If you don't have one, create one.

token (Required)
An authentication token required to see the user's friends events. (What's this?)

per_page (Numeric, Optional, Default = 100)
Number of results to return per page. Max is 100 per page.

page (Numeric, Optional, Default = 1)
The page number of results to return.

Example Response

XML

<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
<event id="280514" name="Event Feb 9 3" description="ds" start_date="2009-03-18" end_date="" start_time="20:00:00" 
end_time="" personal="0" metro_id="1000000" venue_id="14" user_id="5" venue_name="Arrowhead Stadium" status="attend" 
username="localtester_ga03" useractive="1" venue_address="One Arrowhead Dr." venue_city="Kansas City" 
venue_state_name="Missouri" venue_state_code="MO" venue_state_id="1000000" venue_country_name="United States" 
venue_country_code="us" venue_country_id="1000000" venue_zip="64129" venue_url="" venue_phone="" 
ticket_url="" ticket_price="" ticket_free="0">
  <watchlist_results>
      <watchlist user_id="5" name="tret" username="localtester_ga03" status="attend"/>
  </watchlist_results>
</event>
<event id="352505" name="dasd" description="" start_date="2009-03-24" end_date="" start_time="20:00:00" 
end_time="" personal="0" metro_id="1000000" venue_id="17" user_id="5" venue_name="Raymond James Stadium" status="attend" 
username="localtester_ga03" useractive="1" venue_address="4201 N Dale Mabry Hwy" venue_city="Tampa" 
venue_state_name="Florida" venue_state_code="FL" venue_state_id="1000000" venue_country_name="United States" 
venue_country_code="us" venue_country_id="1000000" venue_zip="33607" venue_url="" venue_phone="" 
ticket_url="http://yahoo.com/" ticket_price="" ticket_free="0">
  <watchlist_results>
      <watchlist user_id="5" name="tret" username="localtester_ga03" status="attend"/>
  </watchlist_results>
</event>
</rsp>

JSON

{
  "rsp":{
    "stat":"ok",
    "version":1,
    "event":[
		    {
		      "id":1501305,
		      "name":"Band of Horses",
		      "description":"
\r\nAchieving musical transcendence is a tricky feat, almost definitively. If it happens at all, it happens naturally and perhaps nobody knows that better than Band of Horses. Buoyed by Ben Bridwell's warm, reverb-heavy vocals (which strangely channel a dichotomous blend of Wayne Coyne, Brian Wilson and Doug Martsch,) Band of Horses' woodsy, dreamy songs ooze with amorphous tension, longing and hope.",
		      "start_date":"2009-04-17",
		      "end_date":"",
		      "start_time":"20:00:00",
		      "end_time":"",
		      "personal":0,
		      "metro_id":1000000,
		      "venue_id":406491,
		      "user_id":12757,
		      "venue_name":"Fox Theater",
		      "status":"attend",
		      "username":"1be8431986fe252a95f157180777d21e",
		      "useractive":1,
		      "venue_address":"1807 Telegraph Ave",
		      "venue_city":"Oakland",
		      "venue_state_name":"California",
		      "venue_state_code":"CA",
		      "venue_state_id":1000000,
		      "venue_country_name":"United States",
		      "venue_country_code":"us",
		      "venue_country_id":1000000,
		      "venue_zip":94612,
		      "venue_url":"http:\/\/www.thefoxoakland.com\/",
		      "venue_phone":"",
		      "ticket_url":"http:\/\/www.ticketmaster.com\/promo\/5j26k7",
		      "ticket_price":29.5,
		      "ticket_free":0,
		      "watchlist":[
		    {
		      "user_id":12757,
		      "name":"Upcoming User 12757",
		      "username":"1be8431986fe252a95f157180777d21e",
		      "status":"attend"
		    }
            ]
		    },
		    {
		      "id":1503312,
		      "name":"Mates of State, Black Kids",
		      "description":"",
		      "start_date":"2009-04-19",
		      "end_date":"",
		      "start_time":"20:00:00",
		      "end_time":"",
		      "personal":0,
		      "metro_id":6,
		      "venue_id":9164,
		      "user_id":1,
		      "venue_name":"Wonder Ballroom",
		      "status":"attend",
		      "username":"aefcfdc1ecf1da5cb24de69daaba734a",
		      "useractive":1,
		      "venue_address":"128 NE Russell St",
		      "venue_city":"Portland",
		      "venue_state_name":"Oregon",
		      "venue_state_code":"or",
		      "venue_state_id":38,
		      "venue_country_name":"United States",
		      "venue_country_code":"us",
		      "venue_country_id":1,
		      "venue_zip":97212,
		      "venue_url":"http:\/\/www.wonderballroom.com\/",
		      "venue_phone":"503.284.8686",
		      "ticket_url":"",
		      "ticket_price":"",
		      "ticket_free":0,
		      "watchlist":[
		    {
		      "user_id":1,
		      "name":"Upcoming User 1",
		      "username":"aefcfdc1ecf1da5cb24de69daaba734a",
		      "status":"attend"
		    }
            ]
		    }
      ]
  }
}

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.
Invalid user_id parameter.
Invalid page parameter.
Invalid per_page parameter.
user.getMyFriendsEvents only supports 100 results per page.

Tools: Upcoming Badges for Your Blog/Website | Invite Friends | Groups | Developers API
Help: News Blog | Community Guidelines | FAQ | Contact Us | Suggestion Board | About Us