Show the public timeline


the micro-blogging software


Copyright © 2016-2017, Maiyannah Bishop

Derived from code copyright various sources

  • GNU Social © 2013-2016, Free Software Foundation, Inc
  • StatusNet © 2008-2012, StatusNet, Inc


This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program.  If not, see http://www.gnu.org/licenses/.



Show the public timeline

Returns the 20 most recent notices from users throughout the system who have uploaded their own avatars.  Depending on configuration, it may or may not not include notices from automatic posting services.

HTTP Method(s)

  • GET

URL pattern

  • /api/statuses/public_timeline.:format


  • xml
  • json
  • rss
  • atom

Requires Authentication



  • since_id - (Optional) Returns only statuses with an ID greater than (that is, more recent than) the specified ID.
  • max_id - (Optional) Returns only statuses with an ID less than (that is, older than) or equal to the specified ID.
  • count - (Optional) Specifies the number of statuses to retrieve.
  • page - (Optional) Specifies the page of results to retrieve.


publictimeline statuses/public_timeline

Example usage

curl http://myinstance.com/api/statuses/friends_timeline/maiyannah.xml?count=1&page=2

Example response

<?xml version=”1.0” encoding=”UTF-8”?> <statuses type=”array”> <status> <text>@skwashd oh, commbank reenabled me super quick both times. but disconcerting when you don’t expect it though</text> <truncated>false</truncated> <created_at>Sat Apr 17 00:49:12 +0000 2010</created_at> <in_reply_to_status_id>28838393</in_reply_to_status_id> <source>xmpp</source> <id>28838456</id> <in_reply_to_user_id>39303</in_reply_to_user_id> <in_reply_to_screen_name>skwashd</in_reply_to_screen_name> <geo></geo> <favorited>false</favorited> <user> <id>44517</id> <name>joshua may</name> <screen_name>notjosh</screen_name> <location></location> <description></description> <profile_image_url>url target=”http://avatar.identi.ca/44517-48-20090321004106.jpeg” name=”http://avatar.identi.ca/44517-48-20090321004106.jpeg”</profile_image_url> <url></url> <protected>false</protected> <followers_count>17</followers_count> <profile_background_color></profile_background_color> <profile_text_color></profile_text_color> <profile_link_color></profile_link_color> <profile_sidebar_fill_color></profile_sidebar_fill_color> <profile_sidebar_border_color></profile_sidebar_border_color> <friends_count>20</friends_count> <created_at>Sat Mar 21 00:40:25 +0000 2009</created_at> <favourites_count>0</favourites_count> <utc_offset>0</utc_offset> <time_zone>UTC</time_zone> <profile_background_image_url></profile_background_image_url> <profile_background_tile>false</profile_background_tile> <statuses_count>100</statuses_count> <following>false</following> <notifications>false</notifications> </user> </status>


Usage notes

  • The URL pattern is relative to the @ref apiroot.
  • The XML response uses <a href=”url target=”http://georss.org/Main_Page” name=”http://georss.org/Main_Page””>GeoRSS</a> to encode the latitude and longitude (see example response below <georss:point>).

PHP version

Tested with PHP 7.0

File Authors