サイトのトップへ戻る

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

GET statuses/show/:id

idパラメータで指定したツイートを一つ取得します。取得したツイートにはツイート主の情報も含まれています。

bulk 内のツイート取得についてはGET statuses / lookupを参照してください (up to 100 per call)。 ディスプレイ要件に従ってツイートを描写するツールについては、Embeddable Timelines, Embeddable Tweets, GET statuses/oembedを参照してください。



地理情報について

ジオタグが設定されていなかった場合、 <geo/>"geo" : {}のような空のステータスになります。 これはジオタグAPIを使ってstatuses/updateを送信した場合にのみ設定することができます。

JSON での応答は、ほとんどがGeoJSON形式に準拠しています。 あいにくTwitterが描写する座標はGeoJSON で設定される座標と逆になっています(GeoJSON では経度、緯度の順に指定しますが、現時点でTwitterでは緯度、経度の順に指定します。)。 Twitterの JSON は次のように表現されます: "geo": { "type":"Point", "coordinates":[37.78029, -122.39697] }



寄稿者(contributors)

ツイートに寄稿者(contributors)が存在しない場合、ステータスは空もしくは "contributors" : {}となります。 このフィールドは、ユーザーがアカウントの寄稿者機能を有効にしている場合に設定されます。 — これはまだ一般には使用することができないベータ機能です。

contributorsオブジェクトは、このツイートに寄稿しているユーザーのユーザーIDを配列として保持しています (an example of a status that has been contributed to is this one). 実際のところ、この配列には通常一つのIDのみが入ります。 JSON は次のように表現されます "contributors":[8285392]



リソースURL

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



リソース情報

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


パラメータ

id 必須

取得するツイートの数値型 ID

サンプル値: 123

trim_user 任意

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

サンプル値: true

include_my_retweet 任意

When set to either true, t or 1, any Tweets returned that have been retweeted by the authenticating user will include an additional current_user_retweet node, containing the ID of the source status for the retweet.

サンプル値: true

include_entities 任意

falseを設定すると、そのユーザーのentitiesノードは含まれません。

サンプル値: false



OAuth 署名ジェネレータ

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



リクエスト例

GET

https://api.twitter.com/1.1/statuses/show.json?id=210462857140252672



応答結果の例

{
  "coordinates": null,
  "favorited": false,
  "truncated": false,
  "created_at": "Wed Jun 06 20:07:10 +0000 2012",
  "id_str": "210462857140252672",
  "entities": {
    "urls": [
      {
        "expanded_url": "https://dev.twitter.com/terms/display-guidelines",
        "url": "https://t.co/Ed4omjYs",
        "indices": [
          76,
          97
        ],
        "display_url": "dev.twitter.com/terms/display-…"
      }
    ],
    "hashtags": [
      {
        "text": "Twitterbird",
        "indices": [
          19,
          31
        ]
      }
    ],
    "user_mentions": [

    ]
  },
  "in_reply_to_user_id_str": null,
  "contributors": [
    14927800
  ],
  "text": "Along with our new #Twitterbird, we've also updated our Display Guidelines: https://t.co/Ed4omjYs  ^JC",
  "retweet_count": 66,
  "in_reply_to_status_id_str": null,
  "id": 210462857140252672,
  "geo": null,
  "retweeted": true,
  "possibly_sensitive": false,
  "in_reply_to_user_id": null,
  "place": null,
  "user": {
    "profile_sidebar_fill_color": "DDEEF6",
    "profile_sidebar_border_color": "C0DEED",
    "profile_background_tile": false,
    "name": "Twitter API",
    "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
    "created_at": "Wed May 23 06:01:13 +0000 2007",
    "location": "San Francisco, CA",
    "follow_request_sent": false,
    "profile_link_color": "0084B4",
    "is_translator": false,
    "id_str": "6253282",
    "entities": {
      "url": {
        "urls": [
          {
            "expanded_url": null,
            "url": "http://dev.twitter.com",
            "indices": [
              0,
              22
            ]
          }
        ]
      },
      "description": {
        "urls": [

        ]
      }
    },
    "default_profile": true,
    "contributors_enabled": true,
    "favourites_count": 24,
    "url": "http://dev.twitter.com",
    "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
    "utc_offset": -28800,
    "id": 6253282,
    "profile_use_background_image": true,
    "listed_count": 10774,
    "profile_text_color": "333333",
    "lang": "en",
    "followers_count": 1212963,
    "protected": false,
    "notifications": null,
    "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png",
    "profile_background_color": "C0DEED",
    "verified": true,
    "geo_enabled": true,
    "time_zone": "Pacific Time (US & Canada)",
    "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.",
    "default_profile_image": false,
    "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png",
    "statuses_count": 3333,
    "friends_count": 31,
    "following": true,
    "show_all_inline_media": false,
    "screen_name": "twitterapi"
  },
  "in_reply_to_screen_name": null,
  "source": "web",
  "in_reply_to_status_id": null
}