サイトのトップへ戻る

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




GET lists/list

認証ユーザーもしくは指定したユーザーの購読しているリスト(Lists)を全て取得します。自分自身で作成したリスト合わせて取得します。 ユーザーは user_idパラメータ もしくは screen_nameパラメータを使って指定します。 パラメータが指定されなかった場合、認証ユーザーのIDが指定されます。

このメソッドはAPI バージョン1.0ではGET listとなっていましたが、他のメソッドと書式を揃えるため名前が変更されました。

このメソッドでは最大100個の結果が取得されます。購読しているリストがまず取得され、その後自分のリストが取得されます。 つまり、あるユーザーが90個のリストを購読して自分で作成したリストが20個ある場合、このメソッドでは購読リストを90個と自分のリストを10個取得します。 reverse=true を設定してメソッドを実行した場合、まず自分で作成したリストが取得されるので、自分のリストを20個と購読しているリストを80個取得します。 自分が作成したリストや購読しているリストを全て取得したい場合は、代わりに GET lists / ownerships や GET lists / subscriptions を使用してください。



リソース URL

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



リソース情報

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


パラメータ

user_id 任意

結果を取得するユーザーのID。ユーザーIDとスクリーンネームが同じ場合に、どちらを指定しているのか明確にするために使います。

サンプル値: 12345

注意: リストを取得するユーザーのIDを指定してください。ユーザーIDとスクリーンネームが同じ場合に、どちらを指定しているのか明確にするために使います。

screen_name 任意

結果を取得するユーザーのスクリーンネーム。スクリーンネームとユーザーIDが同じ場合に、どちらを指定しているのか明確にするために使います。

サンプル値: noradio

reverse 任意

自分が作成したリストを先に取得したい場合はtrue を設定します。このパラメータがどのように動作するかの情報については前述の説明を参照してください。

サンプル値: true



OAuth 署名ジェネレータ

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



リクエスト例

GET

https://api.twitter.com/1.1/lists/list.json?screen_name=twitterapi

応答結果の例

[
  {
    "slug": "meetup-20100301",
    "name": "meetup-20100301",
    "created_at": "Sat Feb 27 21:39:24 +0000 2010",
    "uri": "/twitterapi/meetup-20100301",
    "subscriber_count": 147,
    "id_str": "8044403",
    "member_count": 116,
    "mode": "public",
    "id": 8044403,
    "full_name": "@twitterapi/meetup-20100301",
    "description": "Guests attending the Twitter meetup on 1 March 2010 at the @twoffice",
    "user": {
      "profile_background_tile": true,
      "profile_sidebar_border_color": "C0DEED",
      "name": "Twitter API",
      "profile_sidebar_fill_color": "DDEEF6",
      "location": "San Francisco, CA",
      "created_at": "Wed May 23 06:01:13 +0000 2007",
      "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
      "is_translator": false,
      "id_str": "6253282",
      "profile_link_color": "0084B4",
      "follow_request_sent": false,
      "favourites_count": 25,
      "contributors_enabled": true,
      "url": "http://dev.twitter.com",
      "default_profile": false,
      "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
      "utc_offset": -28800,
      "profile_banner_url": "https://si0.twimg.com/profile_banners/6253282/1347394302",
      "id": 6253282,
      "profile_use_background_image": true,
      "listed_count": 11201,
      "profile_text_color": "333333",
      "protected": false,
      "lang": "en",
      "followers_count": 1444739,
      "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.",
      "notifications": false,
      "geo_enabled": true,
      "verified": true,
      "time_zone": "Pacific Time (US & Canada)",
      "profile_background_color": "C0DEED",
      "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
      "statuses_count": 3367,
      "friends_count": 33,
      "default_profile_image": false,
      "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
      "following": true,
      "screen_name": "twitterapi"
    },
    "following": false
  },
  {
    "slug": "team",
    "name": "team",
    "created_at": "Wed Nov 04 01:24:28 +0000 2009",
    "uri": "/twitterapi/team",
    "subscriber_count": 277,
    "id_str": "2031945",
    "member_count": 20,
    "mode": "public",
    "id": 2031945,
    "full_name": "@twitterapi/team",
    "description": "",
    "user": {
      "profile_background_tile": true,
      "profile_sidebar_border_color": "C0DEED",
      "name": "Twitter API",
      "profile_sidebar_fill_color": "DDEEF6",
      "location": "San Francisco, CA",
      "created_at": "Wed May 23 06:01:13 +0000 2007",
      "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
      "is_translator": false,
      "id_str": "6253282",
      "profile_link_color": "0084B4",
      "follow_request_sent": false,
      "favourites_count": 25,
      "contributors_enabled": true,
      "url": "http://dev.twitter.com",
      "default_profile": false,
      "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
      "utc_offset": -28800,
      "profile_banner_url": "https://si0.twimg.com/profile_banners/6253282/1347394302",
      "id": 6253282,
      "profile_use_background_image": true,
      "listed_count": 11201,
      "profile_text_color": "333333",
      "protected": false,
      "lang": "en",
      "followers_count": 1444739,
      "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.",
      "notifications": false,
      "geo_enabled": true,
      "verified": true,
      "time_zone": "Pacific Time (US & Canada)",
      "profile_background_color": "C0DEED",
      "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
      "statuses_count": 3367,
      "friends_count": 33,
      "default_profile_image": false,
      "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
      "following": true,
      "screen_name": "twitterapi"
    },
    "following": true
  }
]