Hatena::Grouphatenadeveloper

はてなブックマークお気に入りフィード仕様

ja/bookmark/misc/favorite_feed

はてなブックマークお気に入りフィード仕様

本ドキュメントに関する注意事項

本ドキュメントははてなブックマークにおけるお気に入りフィード仕様を解説するものです。

フィードの形式

はてなブックマークでは、お気に入りユーザーのブックマークを含むフィードをRSS 1.0形式で提供しています。Atomフィードの提供はございません。

フィードのURL

あるユーザーのお気に入りユーザーのブックマークのフィードは、以下のURLでアクセスできます。ここで、{user}にはそのユーザーのユーザー名(はてなID)が入ります。

http://b.hatena.ne.jp/{user}/favorite.rss

フィードの内容

はてなブックマークお気に入りフィードには、あるユーザーのお気に入りユーザーのブックマークが含まれます。含まれる件数は最大25件で、ブックマーク時刻の新しい順に並んでいます。複数のお気に入りユーザーが同一のエントリーをブックマークしていた場合も、各ユーザーのブックマークごとに1項目が出力されます。

各項目に含まれる内容はユーザーのブックマークのフィードと同じになっています。詳細についてははてなブックマークフィード仕様をご覧ください。

フィードの内容の調節

フィードのURLに以下のクエリパラメータを指定することで、フィードの内容を調節できます。

パラメータ名説明
untiluntil=1325343600のように時刻を表す値を指定することで、その時刻より前のブックマークを取得できます。ここで指定する値はUNIXエポックからの経過秒数として解釈されます。(※1)
ofof=25のようにオフセットを指定することで、過去のブックマークを取得できます。(※2)
with_mewith_me=1のように値"1"を指定すると、あるユーザーのお気に入りユーザーのブックマークだけでなく、そのユーザー自身のブックマークもフィードに含まれるようになります。なお、はてなブックマークプラスの非公開ブックマークはフィードに含まれません。(※3)
  • ※1 2012年1月現在、ベータ公開中の新ユーザーページをご利用の方のみお使いいただけます。
  • ※2 2012年1月現在、ベータ公開中の新ユーザーページをご利用の方には非推奨です。過去のブックマークを取得する際にはuntilパラメータをお使いください。
  • ※3 2012年1月現在、ベータ公開中の新ユーザーページをご利用の方のみお使いいただけます。

変更履歴

  • 2012年1月31日 文書リリース