サイトのトップへ戻る

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

GET favorites/list

認証ユーザーか指定したユーザーのお気に入りツイートを最新20個取得します。



リソースURL

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



リソース情報

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


パラメータ

このメソッドにuser_id と screen_name のどちらも設定しなかった場合、認証ユーザーを検索対象に設定したと見なされます。ベストな結果を得るためには、どちらかを設定してください。

user_id 任意

結果を取得するユーザーのID。

サンプル値: 12345

screen_name 任意

結果を取得するユーザーのスクリーンネーム。

サンプル値: noradio

count 任意

取得sるレコードの数を指定します。200以下の値を設定しなければなりません;既定値は20です。 count値が適用されると停止中のコンテンツや削除されたコンテンツが取り除かれるので、このパラメータは取得するツイート数を制限するものとして考えるのがベストです。

サンプル値: 5

since_id 任意

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

サンプル値: 12345

max_id 任意

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

サンプル値: 54321

include_entities 任意

falseを設定した場合、entitiesノードは含まれません。

サンプル値: false



OAuth 署名ジェネレータ

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



リクエスト例

GET

https://api.twitter.com/1.1/favorites/list.json?count=2&screen_name=episod



応答結果の例

[
  {
    "coordinates": null,
    "truncated": false,
    "favorited": true,
    "created_at": "Tue Sep 04 15:55:52 +0000 2012",
    "id_str": "243014525132091393",
    "in_reply_to_user_id_str": null,
    "entities": {
      "urls": [

      ],
      "hashtags": [

      ],
      "user_mentions": [

      ]
    },
    "text": "Note to self:  don't die during off-peak hours on a holiday weekend.",
    "contributors": null,
    "id": 243014525132091393,
    "retweet_count": 0,
    "in_reply_to_status_id_str": null,
    "geo": null,
    "retweeted": false,
    "in_reply_to_user_id": null,
    "in_reply_to_screen_name": null,
    "source": "web",
    "user": {
      "profile_sidebar_fill_color": "252429",
      "profile_background_tile": true,
      "profile_sidebar_border_color": "181A1E",
      "name": "Sean Cook",
      "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG",
      "location": "San Francisco",
      "created_at": "Sat May 09 17:58:22 +0000 2009",
      "follow_request_sent": false,
      "is_translator": false,
      "id_str": "38895958",
      "profile_link_color": "2FC2EF",
      "entities": {
        "description": {
          "urls": [

          ]
        }
      },
      "favourites_count": 594,
      "url": null,
      "default_profile": false,
      "contributors_enabled": true,
      "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG",
      "utc_offset": -28800,
      "id": 38895958,
      "listed_count": 191,
      "profile_use_background_image": true,
      "followers_count": 10659,
      "protected": false,
      "profile_text_color": "666666",
      "lang": "en",
      "profile_background_color": "1A1B1F",
      "time_zone": "Pacific Time (US & Canada)",
      "verified": false,
      "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png",
      "description": "I taught your phone that thing you like.  The Mobile Partner Engineer @Twitter. ",
      "geo_enabled": true,
      "notifications": false,
      "default_profile_image": false,
      "friends_count": 1186,
      "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png",
      "statuses_count": 2629,
      "following": true,
      "screen_name": "theSeanCook",
      "show_all_inline_media": true
    },
    "place": {
      "name": "San Francisco",
      "country_code": "US",
      "country": "United States",
      "attributes": {
      },
      "url": "http://api.twitter.com/1/geo/id/5a110d312052166f.json",
      "id": "5a110d312052166f",
      "bounding_box": {
        "coordinates": [
          [
            [
              -122.51368188,
              37.70813196
            ],
            [
              -122.35845384,
              37.70813196
            ],
            [
              -122.35845384,
              37.83245301
            ],
            [
              -122.51368188,
              37.83245301
            ]
          ]
        ],
        "type": "Polygon"
      },
      "full_name": "San Francisco, CA",
      "place_type": "city"
    },
    "in_reply_to_status_id": null
  },
  {
    "coordinates": null,
    "truncated": false,
    "favorited": true,
    "created_at": "Tue Sep 04 00:17:11 +0000 2012",
    "id_str": "242778296117514240",
    "in_reply_to_user_id_str": null,
    "entities": {
      "urls": [

      ],
      "hashtags": [

      ],
      "user_mentions": [

      ]
    },
    "text": "TWIT NPC. TWIT DUNGEONMASTER.",
    "contributors": null,
    "id": 242778296117514240,
    "retweet_count": 1,
    "in_reply_to_status_id_str": null,
    "geo": null,
    "retweeted": false,
    "in_reply_to_user_id": null,
    "in_reply_to_screen_name": null,
    "source": "Twitter for Android",
    "user": {
      "profile_sidebar_fill_color": "DDEEF6",
      "profile_background_tile": false,
      "profile_sidebar_border_color": "C0DEED",
      "name": "REGIS",
      "profile_image_url": "http://a0.twimg.com/profile_images/1812284389/allseeingeye_normal.jpg",
      "location": "",
      "created_at": "Wed May 07 19:27:16 +0000 2008",
      "follow_request_sent": false,
      "is_translator": false,
      "id_str": "14690653",
      "profile_link_color": "009999",
      "entities": {
        "description": {
          "urls": [

          ]
        }
      },
      "favourites_count": 46407,
      "url": null,
      "default_profile": false,
      "contributors_enabled": false,
      "profile_image_url_https": "https://si0.twimg.com/profile_images/1812284389/allseeingeye_normal.jpg",
      "utc_offset": -25200,
      "id": 14690653,
      "listed_count": 194,
      "profile_use_background_image": true,
      "followers_count": 4198,
      "protected": false,
      "profile_text_color": "333333",
      "lang": "en",
      "profile_background_color": "131516",
      "time_zone": "Mountain Time (US & Canada)",
      "verified": false,
      "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/530267284/11111.JPG",
      "description": "Everything I tweet is or shall be.",
      "geo_enabled": true,
      "notifications": false,
      "default_profile_image": false,
      "friends_count": 200,
      "profile_background_image_url": "http://a0.twimg.com/profile_background_images/530267284/11111.JPG",
      "statuses_count": 43345,
      "following": true,
      "screen_name": "regisl",
      "show_all_inline_media": false
    },
    "place": null,
    "in_reply_to_status_id": null
  }
]