Statuses/public timeline

«  Return to the list of API methods

Contents

URL

http://yourserver/api/statuses/public_timeline.format

Description

It returns the last 25 notes that all the people with public profile have submitted.

Available formats

RSS, XML, JSON

HTTP Method

GET

Requires authentication

NO

Optional parameters

Return example (XML)

curl http://yourserver/api/statuses/public_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://yourserver/api/statuses/public_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://yourserver/api/statuses/public_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 // Public notes from all the users]]></title>
  <description><![CDATA[Public notes from all the users]]></description>
  <link>http://localhost/trunk/statuses/public_timeline.rss</link>
  <atom:link href="http://localhost/trunk/statuses/public_timeline.rss" rel="self" type="application/rss+xml"/>
  <generator>Jisko</generator>
  <ttl>10</ttl>
  <image>
   <link>http://localhost/trunk/</link>
   <title>Public notes from all the users</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>