This deprecated method is replaced by GET statuses/home_timeline in API v1.1
Returns the most recent statuses, including retweets if they exist, posted by the authenticating user and the users they follow. This is the same timeline seen by a user when they login to twitter.com.
This method is identical to statuses/friends_timeline, except that this method always includes retweets.
This method is can only return up to 800 statuses, including retweets, across all pages.
See Working with Timelines for instructions on traversing timelines.
Resource URL
Parameters
Specifies the number of records to retrieve. Must be less than or equal to 200. Defaults to 20.
Example Values: 5
Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.
Example Values: 12345
Returns results with an ID less than (that is, older than) or equal to the specified ID.
Example Values: 54321
This parameter will soon cease to be functional See Working with Timelines.
Specifies the page of results to retrieve.
Example Values: 3
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
When set to either true, t or 1,the timeline will contain native retweets (if they exist) in addition to the standard stream of tweets. The output format of retweeted tweets is identical to the representation you see in home_timeline. Note: If you're using the trim_user parameter in conjunction with include_rts, the retweets will still contain a full user object.
Example Values: true
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
This parameter will prevent replies from appearing in the returned timeline. Using exclude_replies with the count parameter will mean you will receive up-to count tweets — this is because the count parameter retrieves that many tweets before filtering out retweets and replies.
Example Values: true
This parameter enhances the contributors element of the status response to include the screen_name of the contributor. By default only the user_id of the contributor is included.
Example Values: true
Example Request
GET | |
[
{
"coordinates": null,
"favorited": false,
"created_at": "Fri Jul 16 16:58:46 +0000 2010",
"truncated": false,
"entities": {
"urls": [
{
"expanded_url": null,
"url": "http://www.flickr.com/photos/cindyli/4799054041/",
"indices": [
75,
123
]
}
],
"hashtags": [
],
"user_mentions": [
{
"name": "Stephanie",
"id": 15473839,
"indices": [
27,
39
],
"screen_name": "craftybeans"
}
]
},
"text": "got a lovely surprise from @craftybeans. She sent me the best tshirt ever. http://www.flickr.com/photos/cindyli/4799054041/ ::giggles::",
"annotations": null,
"contributors": null,
"id": 18700887835,
"geo": null,
"in_reply_to_user_id": null,
"place": null,
"in_reply_to_screen_name": null,
"user": {
"name": "cindy li",
"profile_sidebar_border_color": "AD0066",
"profile_background_tile": false,
"profile_sidebar_fill_color": "AD0066",
"created_at": "Wed Nov 29 06:08:08 +0000 2006",
"profile_image_url": "http://a1.twimg.com/profile_images/553508996/43082001_N00_normal.jpg",
"location": "San Francisco, CA",
"profile_link_color": "FF8500",
"follow_request_sent": false,
"url": "http://www.cindyli.com",
"favourites_count": 465,
"contributors_enabled": false,
"utc_offset": -28800,
"id": 29733,
"profile_use_background_image": true,
"profile_text_color": "000000",
"protected": false,
"followers_count": 3395,
"lang": "en",
"notifications": true,
"time_zone": "Pacific Time (US & Canada)",
"verified": false,
"profile_background_color": "cfe8f6",
"geo_enabled": true,
"description": "Just me, Cindy Li.Giving cute substance since 1997.\r\nMarried to @themattharris.\r\nProduct designer for Yahoo! ",
"friends_count": 542,
"statuses_count": 4847,
"profile_background_image_url": "http://a3.twimg.com/profile_background_images/3368753/twitter_flowerbig.gif",
"following": true,
"screen_name": "cindyli"
},
"source": "web",
"in_reply_to_status_id": null
},
{
"coordinates": null,
"favorited": false,
"created_at": "Fri Jul 16 16:55:52 +0000 2010",
"truncated": false,
"entities": {
"urls": [
{
"expanded_url": null,
"url": "http://bit.ly/libraryman",
"indices": [
78,
102
]
}
],
"hashtags": [
],
"user_mentions": [
{
"name": "Cal Henderson",
"id": 6104,
"indices": [
108,
115
],
"screen_name": "iamcal"
}
]
},
"text": "Anything is possible when you're in the library... with a celestial sandwich: http://bit.ly/libraryman (via @iamcal)",
"annotations": null,
"contributors": null,
"id": 18700688341,
"geo": null,
"in_reply_to_user_id": null,
"place": {
"name": "San Francisco",
"country_code": "US",
"country": "The United States of America",
"attributes": {
},
"url": "http://api.twitter.com/1/geo/id/5a110d312052166f.json",
"id": "5a110d312052166f",
"bounding_box": {
"coordinates": [
[
[
-122.51368188,
37.70813196
],
[
-122.35845384,
37.70813196
],
[
-122.35845384,
37.83245301
],
[
-122.51368188,
37.83245301
]
]
],
"type": "Polygon"
},
"full_name": "San Francisco, CA",
"place_type": "city"
},
"in_reply_to_screen_name": null,
"user": {
"name": "Daniel Burka",
"profile_sidebar_border_color": "a655ec",
"profile_background_tile": true,
"profile_sidebar_fill_color": "f1ccff",
"created_at": "Mon Jan 15 15:22:14 +0000 2007",
"profile_image_url": "http://a3.twimg.com/profile_images/74260755/2009-square-small_normal.jpg",
"location": "San Francisco",
"profile_link_color": "5a0d91",
"follow_request_sent": false,
"url": "http://deltatangobravo.com",
"favourites_count": 92,
"contributors_enabled": false,
"utc_offset": -28800,
"id": 635543,
"profile_use_background_image": true,
"profile_text_color": "0C3E53",
"protected": false,
"followers_count": 9950,
"lang": "en",
"notifications": false,
"time_zone": "Pacific Time (US & Canada)",
"verified": false,
"profile_background_color": "BADFCD",
"geo_enabled": true,
"description": "Director of design at Tiny Speck. Ex-Creative director at Digg. CSS. Design. UX. Climbing. Cycling. Chilaquiles mmm.",
"friends_count": 219,
"statuses_count": 806,
"profile_background_image_url": "http://a3.twimg.com/profile_background_images/4444585/back.png",
"following": true,
"screen_name": "dburka"
},
"source": "web",
"in_reply_to_status_id": null
},
...
{
"coordinates": null,
"favorited": false,
"created_at": "Fri Jul 16 16:40:34 +0000 2010",
"truncated": false,
"entities": {
"urls": [
],
"hashtags": [
],
"user_mentions": [
]
},
"text": "Walking the DOM like Huggybear.",
"annotations": null,
"contributors": null,
"id": 18699620902,
"geo": null,
"in_reply_to_user_id": null,
"place": null,
"in_reply_to_screen_name": null,
"user": {
"name": "Kevin Lawver",
"profile_sidebar_border_color": "A8A37E",
"profile_background_tile": true,
"profile_sidebar_fill_color": "E6E2B0",
"created_at": "Sat Jul 29 18:23:37 +0000 2006",
"profile_image_url": "http://a3.twimg.com/profile_images/980477983/oh_lawver_normal.jpg",
"location": "Savannah, GA, US",
"profile_link_color": "DC4104",
"follow_request_sent": false,
"url": "http://lawver.net",
"favourites_count": 148,
"contributors_enabled": false,
"utc_offset": -18000,
"id": 3404,
"profile_use_background_image": true,
"profile_text_color": "003030",
"protected": false,
"followers_count": 1049,
"lang": "en",
"notifications": false,
"time_zone": "Eastern Time (US & Canada)",
"verified": false,
"profile_background_color": "003030",
"geo_enabled": true,
"description": "Nerd who loves web standards, Ruby on Rails and all things webbish. Chief Architect @ http://uplaya.com and co-founder of http://ficly.com. Happy dad & husband.",
"friends_count": 268,
"statuses_count": 10561,
"profile_background_image_url": "http://a1.twimg.com/profile_background_images/1391712/twitter_back.png",
"following": true,
"screen_name": "kplawver"
},
"source": "<a href=\"http://twitter.com\" rel=\"nofollow\">Tweetie for Mac</a>",
"in_reply_to_status_id": null
},
]