サイトのトップへ戻る

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




GET lists/subscribers

指定したリストの購読者を取得します。非公開リストの購読者については、認証ユーザーがそのリストを所有している場合にのみ表示されます。



リソース URL

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



リソース情報

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


パラメータ

list_id か slug のどちらかは必ず設定する必要があります。list_slugを設定した場合は、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。

count 任意

1ページごとに取得する結果の数を指定します(下のcursorの説明を参照してください)。既定値は20。最大値は5000です。

cursor 任意

検索結果を複数のページに分割します。一つのページに20このリストを取得できます。 -1 を設定すると、最初のページからページングを開始します。 応答として返されてきたbody部内のnext_cursor属性とprevious_cursor属性を使って、リスト内の前後のページを操作します。 メソッドがcursorをサポートしている場合は、常にcursorを使用することを推奨します。詳細情報については Using cursors to navigate collections を参照してください。

include_entities 任意

trueか t か 1を設定すると、各ツイートに “entities”と呼ばれるノードが含まれます。 このノードは、ツイートについての様々なメタデータを分割構造で提供します。メタデータには、user_mentions、urls、hashtagsがあります。 現時点のentities は、選択した場合にのみタイムライン上で表示されますが、将来的には既定で表示されるコンポーネントになる予定です。 entitiesの詳細情報については Tweet Entities を参照してください。

skip_status 任意

trueか t か 1を設定した場合、取得したユーザーオブジェクトにステータス情報は含まれません。



OAuth 署名ジェネレータ

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



リクエスト例

GET

https://api.twitter.com/1.1/lists/subscribers.json?include_entities=true&cursor=-1&skip_status=true&slug=team&owner_screen_name=twitter

応答結果の例

{
  "previous_cursor": 0,
  "previous_cursor_str": "0",
  "next_cursor": 1357643166637635702,
  "users": [
    {
      "profile_background_tile": false,
      "profile_sidebar_fill_color": "DDEEF6",
      "name": "Almissen665",
      "profile_sidebar_border_color": "C0DEED",
      "location": null,
      "profile_image_url": "http://a0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png",
      "created_at": "Mon Jun 27 09:17:15 +0000 2011",
      "follow_request_sent": false,
      "is_translator": false,
      "profile_link_color": "0084B4",
      "id_str": "324841714",
      "url": null,
      "default_profile": true,
      "contributors_enabled": false,
      "favourites_count": 0,
      "id": 324841714,
      "utc_offset": null,
      "profile_image_url_https": "https://si0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png",
      "profile_use_background_image": true,
      "listed_count": 0,
      "lang": "en",
      "profile_text_color": "333333",
      "followers_count": 6,
      "protected": false,
      "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png",
      "notifications": false,
      "geo_enabled": false,
      "description": null,
      "profile_background_color": "C0DEED",
      "time_zone": null,
      "verified": false,
      "statuses_count": 1,
      "friends_count": 27,
      "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png",
      "default_profile_image": true,
      "screen_name": "bonasser789",
      "following": false,
      "show_all_inline_media": false
    },
    {
      "profile_sidebar_fill_color": "E6F6F9",
      "profile_sidebar_border_color": "DBE9ED",
      "name": "GR Syber-Space",
      "profile_background_tile": true,
      "location": "Grand Rapids, MI",
      "profile_image_url": "http://a2.twimg.com/profile_images/1322547748/images__97__normal.jpg",
      "created_at": "Thu Sep 30 23:05:38 +0000 2010",
      "profile_link_color": "CC3366",
      "id_str": "197218370",
      "follow_request_sent": false,
      "is_translator": false,
      "url": "http://www.wix.com/castlesportsgr/myj",
      "default_profile": false,
      "favourites_count": 2,
      "contributors_enabled": false,
      "id": 197218370,
      "utc_offset": -18000,
      "profile_image_url_https": "https://si0.twimg.com/profile_images/1322547748/images__97__normal.jpg",
      "profile_use_background_image": true,
      "listed_count": 268,
      "lang": "en",
      "profile_text_color": "333333",
      "followers_count": 2628,
      "protected": true,
      "notifications": false,
      "geo_enabled": true,
      "profile_background_color": "DBE9ED",
      "description": "Welcome to Teen Gossip 411. Celebrity Gossip, Teens fashion trends for the summer 2011, Hollywood Gossip, Hotest music, Teen Websites, and more.",
      "time_zone": "Quito",
      "verified": false,
      "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/237705957/images__97_.jpg",
      "default_profile_image": false,
      "friends_count": 2846,
      "profile_background_image_url": "http://a2.twimg.com/profile_background_images/237705957/images__97_.jpg",
      "statuses_count": 7463,
      "show_all_inline_media": true,
      "screen_name": "GRSYBERSPACE",
      "following": false
    }
  ],
  "next_cursor_str": "1357643166637635702"
}