サイトのトップへ戻る

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




GET lists/statuses

指定したリストのメンバーがつぶやいているツイートのタイムラインを取得します。既定ではリツイートも含まれます。リツイートを省略するには include_rts=false パラメータを使用してください。

埋め込み型タイムラインはあなたのウェブサイトにリストのタイムラインを埋め込むための素晴らしい方法です。



リソース URL

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



リソース情報

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


パラメータ

list_id と slug のうちどちらかは必ず設定してください。 list_idを設定した場合は、 owner_screen_name か owner_id のいずれかも設定する必要があります。

list_id 必須

リストの数値型id。

slug 必須

数値型idではなく slug を使ってリストを識別することができます。もしslugを使用する場合は、owner_idパラメータや owner_screen_nameパラメータを使ってリストの所有者も指定しなければならないので注意してください。

owner_screen_name 任意

slugでリクエストしたリストを所有するユーザーのスクリーンネーム.

owner_id optional

slugでリクエストしたリストを所有するユーザーのユーザーID。

since_id 任意

これに指定したIDよりも大きい(より新しい)IDの検索結果を取得します。このAPIでアクセスできるツイート数には制限があります。 since_idで設定した範囲がツイート数の制限に引っかかった場合、since_id は使用できる範囲で最も古いIDに置き換えられます。

max_id 任意

これに指定したID以下(より古い)のIDの検索結果を取得します。

count 任意

1ページごとに取得する結果の数を指定します。

include_entities 任意

API 1.1では既定でEntities が有効になっており、各ツイートに “entities”と呼ばれるノードが含まれます。 このノードは、ツイートについての様々なメタデータを分割構造で提供します。メタデータには、user_mentions、urls、hashtagsがあります。include_entities=falseと設定すると結果からentities を省略することができます。

include_rts 任意

trueか tか 1を設定した場合、リストのタイムラインには、標準のツイートストリームに加えてリツイートが(もしあれば)含まれます。 リツイートの表示形式は、ホームタイムライン(home_timeline)上の表示と同じです。



OAuth 署名ジェネレータ

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



リクエスト例

GET

https://api.twitter.com/1.1/lists/statuses.json?slug=teams&owner_screen_name=MLS&count=1

応答結果の例

[
  {
    "coordinates": null,
    "created_at": "Mon Sep 10 14:04:58 +0000 2012",
    "truncated": false,
    "favorited": false,
    "id_str": "245160944223793152",
    "in_reply_to_user_id_str": null,
    "entities": {
      "urls": [
        {
          "expanded_url": "http://bit.ly/MuCCDo",
          "url": "http://t.co/W2tON3OK",
          "indices": [
            41,
            61
          ],
          "display_url": "bit.ly/MuCCDo"
        }
      ],
      "hashtags": [
        {
          "text": "TorontoFC",
          "indices": [
            87,
            97
          ]
        },
        {
          "text": "MLS",
          "indices": [
            98,
            102
          ]
        }
      ],
      "user_mentions": [
        {
          "name": "Team Up Foundation",
          "id_str": "210844741",
          "id": 210844741,
          "indices": [
            76,
            86
          ],
          "screen_name": "TeamUpFdn"
        }
      ]
    },
    "text": "Create your own TFC ESQ by Movado Watch: http://t.co/W2tON3OK in support of @TeamUpFdn #TorontoFC #MLS",
    "contributors": null,
    "id": 245160944223793152,
    "retweet_count": 0,
    "in_reply_to_status_id_str": null,
    "geo": null,
    "retweeted": false,
    "possibly_sensitive": false,
    "in_reply_to_user_id": null,
    "in_reply_to_screen_name": null,
    "source": "TweetDeck",
    "user": {
      "profile_sidebar_fill_color": "EB1D31",
      "profile_background_tile": false,
      "profile_sidebar_border_color": "FFFFFF",
      "name": "Toronto FC",
      "profile_image_url": "http://a0.twimg.com/profile_images/1827235104/TorontoFC1_normal.jpg",
      "created_at": "Fri Sep 11 15:42:26 +0000 2009",
      "location": "Toronto, ON",
      "follow_request_sent": false,
      "is_translator": false,
      "id_str": "73412535",
      "profile_link_color": "000000",
      "entities": {
        "url": {
          "urls": [
            {
              "expanded_url": null,
              "url": "http://www.torontofc.ca",
              "indices": [
                0,
                23
              ],
              "display_url": null
            }
          ]
        },
        "description": {
          "urls": [

          ]
        }
      },
      "favourites_count": 2,
      "url": "http://www.torontofc.ca",
      "default_profile": false,
      "contributors_enabled": false,
      "profile_image_url_https": "https://si0.twimg.com/profile_images/1827235104/TorontoFC1_normal.jpg",
      "utc_offset": -18000,
      "id": 73412535,
      "listed_count": 1078,
      "profile_use_background_image": true,
      "followers_count": 28281,
      "protected": false,
      "profile_text_color": "000000",
      "lang": "en",
      "profile_background_color": "BC1228",
      "verified": true,
      "time_zone": "Eastern Time (US & Canada)",
      "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/603424485/k9py0fm18qrjr8l22qlp.jpeg",
      "notifications": false,
      "description": "Official Toronto FC Twitter by @AsifinToronto & @JonSinden. Follow us for the latest club news, links, pics & videos. Join us during matches for #TFClive",
      "geo_enabled": false,
      "default_profile_image": false,
      "friends_count": 13947,
      "profile_background_image_url": "http://a0.twimg.com/profile_background_images/603424485/k9py0fm18qrjr8l22qlp.jpeg",
      "statuses_count": 10774,
      "screen_name": "torontofc",
      "following": true,
      "show_all_inline_media": false
    },
    "place": null,
    "in_reply_to_status_id": null
  }
]