Statuses/friends timeline

«  Return to the list of API methods

Contents

URL

http://youserver/statuses/friends_timeline.format

Description

It shows the last 25 notes from the people you are following

Available formats

XML, JSON

HTTP Method

GET

Requires authentication

YES

Optional parameters

Return example (XML)

curl http://youserver/statuses/friends_timeline.xml
<?xml version="1.0" encoding="UTF-8"?>
<statuses type="array">
 <status>
  <id>33</id>
  <created_at>Sat Apr 17 13:00:11 +0000 2010</created_at>
  <text>abc</text>
  <source>web</source>
  <truncated>false</truncated>
  <in_reply_to_status_id/>
  <in_reply_to_user_id/>
  <favorited>false</favorited>
  <in_reply_to_screen_name/>
  <user>
   <id>1</id>
   <name>marcosgdf</name>
   <screen_name>marcosgdf</screen_name>
   <location/>
   <description/>
   <profile_image_url>http://localhost/trunk/static/img/avatar/default_note.png</profile_image_url>
   <url/>
   <protected>true</protected>
   <followers_count>0</followers_count>
   <created_at>Fri Apr 16 20:12:11 +0000 2010</created_at>
   <favourites_count>0</favourites_count>
   <statuses_count>5</statuses_count>
   <friends_count>0</friends_count>
   <following>false</following>
   <utc_offset/>
   <geo_enabled>false</geo_enabled>
   <time_zone/>
   <profile_background_image_url>http://localhost/trunk/themes/transparency/img/bg.png</profile_background_image_url>
   <profile_background_tile>false</profile_background_tile>
   <notifications>false</notifications>
   <verified>false</verified>
   <lang>default</lang>
   <contributors_enabled>false</contributors_enabled>
  </user>
 </status>
</statuses>

Return example (JSON)

curl http://youserver/statuses/friends_timeline.json
[
    {
        "id": 33,
        "created_at": "Sat Apr 17 13:00:11 +0000 2010",
        "text": "abc",
        "source": "web",
        "truncated": false,
        "in_reply_to_status_id": null,
        "in_reply_to_user_id": null,
        "in_reply_to_screen_name": null,
        "geo": null,
        "favorited": false,
        "contributors": null,
        "coordinates": null,
        "user": {
            "id": 1,
            "name": "marcosgdf",
            "screen_name": "marcosgdf",
            "location": null,
            "description": "",
            "profile_image_url": "http:\/\/localhost\/trunk\/static\/img\/avatar\/default_note.png",
            "url": null,
            "protected": true,
            "followers_count": "0",
            "created_at": "Fri Apr 16 20:12:11 +0000 2010",
            "favourites_count": 0,
            "statuses_count": "5",
            "friends_count": "0",
            "following": false,
            "utc_offset": null,
            "time_zone": null,
            "profile_background_image_url": "themes\/transparency\/img\/bg.png",
            "profile_background_tile": false,
            "notifications": false,
            "verified": false,
            "lang": "default",
            "contributions_enabled": false,
            "geo_enabled": false
        }
    }
]

Return example (RSS)

curl http://youserver/statuses/friends_timeline.rss
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:wfw="http://wellformedweb.org/CommentAPI/" xmlns:dc="http://purl.org/dc/elements/1.1/">
 <channel>
  <title><![CDATA[jiskotest // Notes of marcosgdf + it's followings]]></title>
  <description><![CDATA[Notes of marcosgdf + it's followings]]></description>
  <link>http://localhost/trunk/statuses/friends_timeline.rss</link>
  <atom:link href="http://localhost/trunk/statuses/friends_timeline.rss" rel="self" type="application/rss+xml"/>
  <generator>Jisko</generator>
  <ttl>10</ttl>
  <image>
   <link>http://localhost/trunk/</link>
   <title>Notes of marcosgdf + it's followings</title>
   <url>http://localhost/trunk/static/img/logos/logo.png</url>
  </image>
  <item>
   <title><![CDATA[marcosgdf: abc]]></title>
   <description><![CDATA[marcosgdf: abc]]></description>
   <pubDate>Sat, 17 Apr 2010 15:00:11 +0200</pubDate>
   <link>http://localhost/trunk/marcosgdf/33</link>
   <guid>http://localhost/trunk/marcosgdf/33</guid>
   <dc:creator>marcosgdf</dc:creator>
   <source url="http://localhost/trunk/rss/profile?u=marcosgdf">marcosgdf's notes feed</source>
  </item>
 </channel>
</rss>