GET statuses/home_timeline

GET	`https://api.twitter.com/1/statuses/home_timeline.json?include_entities=true`

```
[
```
```
  {
```
```
    "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
```
```
  },
```
```
]
```

Rate Limited?	Yes
Requires Authentication?	Yes
Response Formats	json xml rss
HTTP Methods	GET
Response Object	Tweets
API Version	v1

GET statuses/home_timeline

This deprecated method is replaced by GET statuses/home_timeline in API v1.1

Resource URL

Parameters

Example Request

Deprecation notice!

Resource Information

OAuth tool

Related Documentation

Related Questions

Tags