GET statuses/lookup

Returns fully-hydrated tweet objects for up to 100 tweets per request, as specified by comma-separated values passed to the id parameter.

This method is especially useful to get the details (hydrate) a collection of Tweet IDs.

GET statuses / show / :id is used to retrieve a single tweet object.

There are a few things to note when using this method.

  • You must be following a protected user to be able to see their most recent tweets. If you don’t follow a protected user their status will be removed.
  • The order of tweet IDs may not match the order of tweets in the returned array.
  • If a requested tweet is unknown or deleted, then that tweet will not be returned in the results list, unless the map parameter is set to true, in which case it will be returned with a value of null.
  • If none of your lookup criteria matches valid tweet IDs an empty array will be returned for map=false.
  • You are strongly encouraged to use a POST for larger requests.

Resource URL

https://api.twitter.com/1.1/statuses/lookup.json

Resource Information

Response formats
JSON
Requires authentication?
Yes
Rate limited?
Yes
Requests / 15-min window (user auth)
180
Requests / 15-min window (app auth)
60

Parameters

idrequired

A comma separated list of tweet IDs, up to 100 are allowed in a single request.

Example Values: 20, 432656548536401920

include_entities optional

The entities node that may appear within embedded statuses will be disincluded when set to false.

Example Values: false

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

map optional

When using the map parameter, tweets that do not exist or cannot be viewed by the current user will still have their key represented but with an explicitly null value paired with it

.

Example Values: true

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

https://api.twitter.com/1.1/statuses/lookup.json?id=20,432656548536401920

Example Result

[
  {
    "created_at": "Tue Mar 21 20:50:14 +0000 2006",
    "id": 20,
    "id_str": "20",
    "text": "just setting up my twttr",
    "source": "web",
    "truncated": false,
    "in_reply_to_status_id": null,
    "in_reply_to_status_id_str": null,
    "in_reply_to_user_id": null,
    "in_reply_to_user_id_str": null,
    "in_reply_to_screen_name": null,
    "user": {
      "id": 12,
      "id_str": "12",
      "name": "Jack Dorsey",
      "screen_name": "jack",
      "location": "California",
      "description": "",
      "url": null,
      "entities": {
        "description": {
          "urls": []
        }
      },
      "protected": false,
      "followers_count": 2577282,
      "friends_count": 1085,
      "listed_count": 23163,
      "created_at": "Tue Mar 21 20:50:14 +0000 2006",
      "favourites_count": 2449,
      "utc_offset": -25200,
      "time_zone": "Pacific Time (US & Canada)",
      "geo_enabled": true,
      "verified": true,
      "statuses_count": 14447,
      "lang": "en",
      "contributors_enabled": false,
      "is_translator": false,
      "is_translation_enabled": false,
      "profile_background_color": "EBEBEB",
      "profile_background_image_url": "http://abs.twimg.com/images/themes/theme7/bg.gif",
      "profile_background_image_url_https": "https://abs.twimg.com/images/themes/theme7/bg.gif",
      "profile_background_tile": false,
      "profile_image_url": "http://pbs.twimg.com/profile_images/448483168580947968/pL4ejHy4_normal.jpeg",
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/448483168580947968/pL4ejHy4_normal.jpeg",
      "profile_banner_url": "https://pbs.twimg.com/profile_banners/12/1347981542",
      "profile_link_color": "990000",
      "profile_sidebar_border_color": "DFDFDF",
      "profile_sidebar_fill_color": "F3F3F3",
      "profile_text_color": "333333",
      "profile_use_background_image": true,
      "default_profile": false,
      "default_profile_image": false,
      "following": true,
      "follow_request_sent": false,
      "notifications": false
    },
    "geo": null,
    "coordinates": null,
    "place": null,
    "contributors": null,
    "retweet_count": 23936,
    "favorite_count": 21879,
    "entities": {
      "hashtags": [],
      "symbols": [],
      "urls": [],
      "user_mentions": []
    },
    "favorited": false,
    "retweeted": false,
    "lang": "en"
  },
  {
    "created_at": "Sun Feb 09 23:25:34 +0000 2014",
    "id": 432656548536401920,
    "id_str": "432656548536401920",
    "text": "POST statuses/update. Great way to start. https://t.co/9S8YO69xzf (disclaimer, this was not posted via the API).",
    "source": "web",
    "truncated": false,
    "in_reply_to_status_id": null,
    "in_reply_to_status_id_str": null,
    "in_reply_to_user_id": null,
    "in_reply_to_user_id_str": null,
    "in_reply_to_screen_name": null,
    "user": {
      "id": 2244994945,
      "id_str": "2244994945",
      "name": "TwitterDev",
      "screen_name": "TwitterDev",
      "location": "Internet",
      "description": "Developers and Platform Relations @Twitter. We are developers advocates. We can't answer all your questions, but we listen to all of them!",
      "url": "https://t.co/66w26cua1O",
      "entities": {
        "url": {
          "urls": [
            {
              "url": "https://t.co/66w26cua1O",
              "expanded_url": "https://dev.twitter.com/",
              "display_url": "dev.twitter.com",
              "indices": [
                0,
                23
              ]
            }
          ]
        },
        "description": {
          "urls": []
        }
      },
      "protected": false,
      "followers_count": 3147,
      "friends_count": 909,
      "listed_count": 53,
      "created_at": "Sat Dec 14 04:35:55 +0000 2013",
      "favourites_count": 61,
      "utc_offset": -25200,
      "time_zone": "Pacific Time (US & Canada)",
      "geo_enabled": false,
      "verified": true,
      "statuses_count": 217,
      "lang": "en",
      "contributors_enabled": false,
      "is_translator": false,
      "is_translation_enabled": false,
      "profile_background_color": "FFFFFF",
      "profile_background_image_url": "http://abs.twimg.com/images/themes/theme1/bg.png",
      "profile_background_image_url_https": "https://abs.twimg.com/images/themes/theme1/bg.png",
      "profile_background_tile": false,
      "profile_image_url": "http://pbs.twimg.com/profile_images/431949550836662272/A6Ck-0Gx_normal.png",
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/431949550836662272/A6Ck-0Gx_normal.png",
      "profile_banner_url": "https://pbs.twimg.com/profile_banners/2244994945/1391977747",
      "profile_link_color": "0084B4",
      "profile_sidebar_border_color": "FFFFFF",
      "profile_sidebar_fill_color": "DDEEF6",
      "profile_text_color": "333333",
      "profile_use_background_image": false,
      "default_profile": false,
      "default_profile_image": false,
      "following": true,
      "follow_request_sent": false,
      "notifications": false
    },
    "geo": null,
    "coordinates": null,
    "place": null,
    "contributors": null,
    "retweet_count": 1,
    "favorite_count": 5,
    "entities": {
      "hashtags": [],
      "symbols": [],
      "urls": [
        {
          "url": "https://t.co/9S8YO69xzf",
          "expanded_url": "https://dev.twitter.com/docs/api/1.1/post/statuses/update",
          "display_url": "dev.twitter.com/docs/api/1.1/p…",
          "indices": [
            42,
            65
          ]
        }
      ],
      "user_mentions": []
    },
    "favorited": false,
    "retweeted": false,
    "possibly_sensitive": false,
    "lang": "en"
  }
]