<< Back to Twitter API Documentation

 

statuses/friends_timeline

Returns the 20 most recent statuses posted by the authenticating user and that user's friends. This is the equivalent of /timeline/home on the Web.

Note: Retweets will not appear in the friends_timeline for backwards compatibility. If you want retweets included use Twitter REST API Method: statuses home_timeline.

URL:

http://twitter.com/statuses/friends_timeline.format

 

Formats: 

xml, json, rss, atom 

 

HTTP Method(s):

GET

 

Requires Authentication (about authentication):

true

 

API rate limited (about rate limiting):

1 call per request

 

Parameters:

• since_id.  Optional.  Returns only statuses with an ID greater than (that is, more recent than) the specified ID. 
  • Example: http://twitter.com/statuses/friends_timeline.xml?since_id=12345
• max_id. Optional.  Returns only statuses with an ID less than (that is, older than) or equal to the specified ID.
  • Example: http://twitter.com/statuses/friends_timeline.xml?max_id=54321
• count.  Optional.  Specifies the number of statuses to retrieve. May not be greater than 200. (Note the the number of statuses returned may be smaller than the requested count as retweets are stripped out of the result set for backwards compatibility.)
  • Example: http://twitter.com/statuses/friends_timeline.xml?count=5 

• page. Optional. Specifies the page of results to retrieve. Note: there are pagination limits.

  • Example: http://twitter.com/statuses/friends_timeline.rss?page=3

 

Response (about return values): 

          XML example (truncated):

<?xml version="1.0" encoding="UTF-8"?>

<statuses>

     <status>

<created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>

<id>1472669360</id>

<text>At least I can get your humor through tweets. RT @abdur: I don't mean this in a bad way, but genetically speaking your a cul-de-sac.</text>

<source><a href="http://www.tweetdeck.com/">TweetDeck</a></source>

<truncated>false</truncated>

<in_reply_to_status_id></in_reply_to_status_id>

<in_reply_to_user_id></in_reply_to_user_id>

<favorited>false</favorited>

<in_reply_to_screen_name></in_reply_to_screen_name>

<user>

<id>1401881</id>

 <name>Doug Williams</name>

 <screen_name>dougw</screen_name>

 <location>San Francisco, CA</location>

 <description>Twitter API Support. Internet, greed, users, dougw and opportunities are my passions.</description>

 <profile_image_url>http://s3.amazonaws.com/twitter_production/profile_images/59648642/avatar_normal.png</profile_image_url>

 <url>http://www.igudo.com</url>

 <protected>false</protected>

 <followers_count>1027</followers_count>

 <profile_background_color>9ae4e8</profile_background_color>

 <profile_text_color>000000</profile_text_color>

 <profile_link_color>0000ff</profile_link_color>

 <profile_sidebar_fill_color>e0ff92</profile_sidebar_fill_color>

 <profile_sidebar_border_color>87bc44</profile_sidebar_border_color>

 <friends_count>293</friends_count>

 <created_at>Sun Mar 18 06:42:26 +0000 2007</created_at>

 <favourites_count>0</favourites_count>

 <utc_offset>-18000</utc_offset>

 <time_zone>Eastern Time (US & Canada)</time_zone>

 <profile_background_image_url>http://s3.amazonaws.com/twitter_production/profile_background_images/2752608/twitter_bg_grass.jpg</profile_background_image_url>

 <profile_background_tile>false</profile_background_tile>

 <statuses_count>3390</statuses_count>

 <notifications>false</notifications>

 <following>false</following>

 <verified>true</verified>

</user>

<geo/>

     </status>

     ... truncated ...

</statuses> 

 

Usage examples: 

cURL (about cURL):

curl -u user:password http://twitter.com/statuses/friends_timeline.xml

 

          Do you have an example to share in the language of your choice? Please share!

 

<< Back to Twitter API Documentation