サイトのトップへ戻る

Twitter 開発者 ドキュメント日本語訳




GET statuses/lookup

idパラメータにコンマ区切りの値を指定することで、一回のリクエストで最大100個の詳細な ツイートオブジェクトを取得します。

このメソッドはたくさんのツイートIDの詳細(hydrate)を取得する場合に特に便利です。

ツイートオブジェクトを一つ取得するにはGET statuses / show / :idを使います。

このメソッドを使う際に注意すべきことがいくつかあります。

  • プロテクトユーザーの最新のツイートを見るには、そのユーザーをフォローしていなければなりません。 プロテクトユーザーをフォローしていない場合は、そのユーザーのツイートは除外されます。
  • ツイートIDの順番は、取得した配列内のツイートの順番と一致しないこともあります。
  • 取得するツイートが不明だったり削除されている場合、 mapパラメータにtrueが設定されていなければ何も返しません。 mapパラメータにtrueが設定されていると、 nullの値が返されます。
  • 検索条件に合致する有効なツイートIDがない場合、空の配列が返されます for map=false。
  • You are strongly encouraged to use a POST for larger requests.


リソースURL

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

リソース情報

応答形式
JSON
認証は必要ですか?
はい
レート制限はありますか?
はい
リクエスト回数 / 15分 window (ユーザー認証の場合)
180
リクエスト回数 / 15分 window (アプリケーション認証の場合)
60


パラメータ

id 必須

一回のリクエストで、最大100までのツイートIDをコンマ区切りで設定できます。

サンプル値: 20, 432656548536401920

include_entities 任意

falseを設定すると、embedded ステータス内のentitiesノードは含まれません。

サンプル値: false

trim_user 任意

trueか t か 1を設定すると、取得したタイムライン上の各ツイートは、ツイート主の数値型IDのみを持ったユーザーオブジェクトを内包します。 このパラメータを省略すると、完全なユーザーオブジェクトを取得します。

サンプル値: true

map 任意

map パラメータを使用した場合、存在しないツイートや参照できないツイートの場合でも、それらを表すキー情報とnull値の組み合わせを取得します。

サンプル値: true



OAuth 署名ジェネレータ

ログインして登録アプリケーションの一覧を参照してください。



リクエスト例

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

応答結果の例

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