GET statuses/public_timeline

Updated on Tue, 2012-10-09 18:25

This method has been removed from service. Please use GET statuses/sample instead for obtaining recent public tweets.

Returned the 20 most recent statuses, including retweets if they existed, from non-protected users.

The public timeline was cached for 60 seconds.

Requesting more frequently than that would not return any more data, and would count against developer's rate limit usage.

Resource URL

http://api.twitter.com/1/statuses/public_timeline.format

Parameters

trim_user optional

When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.

Example Values: true

include_entities optional

When set to either true, t or 1, each tweet will include a node called "entities,". This node offers a variety of metadata about the tweet in a discreet structure, including: user_mentions, urls, and hashtags. While entities are opt-in on timelines at present, they will be made a default component of output in the future. See Tweet Entities for more detail on entities.

Example Values: true

Example Request

GET

https://api.twitter.com/1/statuses/public_timeline.json?count=3&include_entities=true

  1. [
  2.   {
  3.     "coordinates": null,
  4.     "favorited": false,
  5.     "created_at": "Thu Jul 15 23:26:44 +0000 2010",
  6.     "truncated": false,
  7.     "text": "qu por qu kieres saver como poner pablito",
  8.     "contributors": null,
  9.     "id": 18639485000,
  10.     "geo": null,
  11.     "in_reply_to_user_id": null,
  12.     "place": null,
  13.     "in_reply_to_screen_name": null,
  14.     "user": {
  15.       "name": "paul isaias gallegos",
  16.       "profile_sidebar_border_color": "eeeeee",
  17.       "profile_background_tile": false,
  18.       "profile_sidebar_fill_color": "efefef",
  19.       "created_at": "Sun Jun 06 19:56:50 +0000 2010",
  20.       "profile_image_url": "http://a1.twimg.com/profile_images/972549385/m_e26ddd7e7a424fdebceef1b3d005011f_normal.jpg",
  21.       "location": "",
  22.       "profile_link_color": "009999",
  23.       "follow_request_sent": null,
  24.       "url": null,
  25.       "favourites_count": 0,
  26.       "contributors_enabled": false,
  27.       "utc_offset": -21600,
  28.       "id": 152752917,
  29.       "profile_use_background_image": true,
  30.       "profile_text_color": "333333",
  31.       "protected": false,
  32.       "followers_count": 1,
  33.       "lang": "es",
  34.       "notifications": null,
  35.       "time_zone": "Central Time (US & Canada)",
  36.       "verified": false,
  37.       "profile_background_color": "131516",
  38.       "geo_enabled": false,
  39.       "description": "",
  40.       "friends_count": 2,
  41.       "statuses_count": 18,
  42.       "profile_background_image_url": "http://a3.twimg.com/profile_background_images/122541097/m_4011538d4b734ec7923bd641d2fa274f.jpg",
  43.       "following": null,
  44.       "screen_name": "izaloko"
  45.     },
  46.     "source": "web",
  47.     "in_reply_to_status_id": null
  48.   },
  49.   ...
  50.   {
  51.     "coordinates": null,
  52.     "favorited": false,
  53.     "created_at": "Thu Jul 15 23:26:04 +0000 2010",
  54.     "truncated": false,
  55.     "text": "RT @ApeyBaby44: Labels r run by lawyer & accountants. They see their artist as gimmicks they'll sell u now (cont) http://tl.gd/2hkmas",
  56.     "contributors": null,
  57.     "id": 18639444000,
  58.     "geo": null,
  59.     "in_reply_to_user_id": null,
  60.     "place": null,
  61.     "in_reply_to_screen_name": null,
  62.     "user": {
  63.       "name": "DIGGZ",
  64.       "profile_sidebar_border_color": "F2E195",
  65.       "profile_background_tile": true,
  66.       "profile_sidebar_fill_color": "FFF7CC",
  67.       "created_at": "Fri Apr 03 03:16:01 +0000 2009",
  68.       "profile_image_url": "http://a3.twimg.com/profile_images/1079346239/untitled_normal.JPG",
  69.       "location": "ATL, NC, VA, NY all day!",
  70.       "profile_link_color": "FF0000",
  71.       "follow_request_sent": null,
  72.       "url": "http://thisisseriousbiz.com",
  73.       "favourites_count": 42,
  74.       "contributors_enabled": false,
  75.       "utc_offset": -18000,
  76.       "id": 28489988,
  77.       "profile_use_background_image": true,
  78.       "profile_text_color": "0C3E53",
  79.       "protected": false,
  80.       "followers_count": 588,
  81.       "lang": "en",
  82.       "notifications": null,
  83.       "time_zone": "Quito",
  84.       "verified": false,
  85.       "profile_background_color": "BADFCD",
  86.       "geo_enabled": true,
  87.       "description": "Half of Production duo SeriousBIZ circa 2008\r\n#teamSERIOUSBIZ\r\n#teamblackberry PIN 315442C9\r\n#teamfollowback",
  88.       "friends_count": 477,
  89.       "statuses_count": 6269,
  90.       "profile_background_image_url": "http://a1.twimg.com/profile_background_images/118926256/_MG_43571.JPG",
  91.       "following": null,
  92.       "screen_name": "DIGGZSeriousBIZ"
  93.     },
  94.     "source": "<a href=\"http://www.ubertwitter.com/bb/download.php\" rel=\"nofollow\">\u00dcberTwitter</a>",
  95.     "in_reply_to_status_id": null
  96.   },
  97.   {
  98.     "coordinates": null,
  99.     "favorited": false,
  100.     "created_at": "Thu Jul 15 23:26:03 +0000 2010",
  101.     "truncated": false,
  102.     "text": "SE QUISESSEMOS VER V\u00cdDEO IRIAMOS AO YOUTUBE..NAO VIRIAMOS AKI (@gabii_elaa live on http://twitcam.com/16g41)",
  103.     "contributors": null,
  104.     "id": 18639443000,
  105.     "geo": null,
  106.     "in_reply_to_user_id": null,
  107.     "place": null,
  108.     "in_reply_to_screen_name": null,
  109.     "user": {
  110.       "name": "fernando maia ",
  111.       "profile_sidebar_border_color": "181A1E",
  112.       "profile_background_tile": false,
  113.       "profile_sidebar_fill_color": "252429",
  114.       "created_at": "Mon Jul 06 16:11:03 +0000 2009",
  115.       "profile_image_url": "http://a3.twimg.com/profile_images/302998843/Imagem_056_normal.jpg",
  116.       "location": "",
  117.       "profile_link_color": "2FC2EF",
  118.       "follow_request_sent": false,
  119.       "url": null,
  120.       "favourites_count": 1,
  121.       "contributors_enabled": false,
  122.       "utc_offset": -10800,
  123.       "id": 54248373,
  124.       "profile_use_background_image": true,
  125.       "profile_text_color": "666666",
  126.       "protected": false,
  127.       "followers_count": 28,
  128.       "lang": "en",
  129.       "notifications": false,
  130.       "time_zone": "Brasilia",
  131.       "verified": false,
  132.       "profile_background_color": "1A1B1F",
  133.       "geo_enabled": false,
  134.       "description": "",
  135.       "friends_count": 61,
  136.       "statuses_count": 296,
  137.       "profile_background_image_url": "http://s.twimg.com/a/1278951078/images/themes/theme9/bg.gif",
  138.       "following": false,
  139.       "screen_name": "fernandoomaia"
  140.     },
  141.     "source": "<a href=\"http://dev.twitter.com/\" rel=\"nofollow\">API</a>",
  142.     "in_reply_to_status_id": null
  143.   }
  144. ]