はてなブックマーク REST API
はじめに
はてなブックマーク REST API を使うと、はてなブックマークのブックマーク、エントリーなどの情報を取得したり、新規に作成・投稿したりできます。
本ドキュメントに関する注意事項
API の仕様は予告なく変更される可能性があります。
過剰な連続アクセス、 User-Agent
を正しく指定しないアクセスなどは予告なしに制限をかける場合があります。
バージョン
2013年8月、バージョン1が提供されました。
認証
本 API は OAuth によるユーザー認証に対応しています。OAuth 認証の詳細に関しては、はてなサービスにおける OAuth を参照してください。
提供するフォーマット
JSON 形式をサポートしております。各 API の出力の例をご覧ください。
ブックマーク API
名前 | 実行する操作 |
---|---|
GET /rest/1/my/bookmark | ブックマーク情報を取得する |
POST /rest/1/my/bookmark | ブックマークを追加または更新する |
DELETE /rest/1/my/bookmark | ブックマークを削除する |
OAuth 認証したユーザーのブックマークの情報を取得・操作する API です。
エントリー API
名前 | 実行する操作 |
---|---|
GET /rest/1/entry | ブックマークされたエントリーの情報を取得する |
ブックマークされたエントリーの情報を取得する API です。
タグ API
名前 | 実行する操作 |
---|---|
GET /rest/1/my/tags | ユーザーのタグの情報を取得する |
OAuth 認証したユーザーのタグの情報を取得する API です。
ユーザー情報 API
名前 | 実行する操作 |
---|---|
GET /rest/1/my | ユーザーの情報を取得する |
OAuth 認証したユーザーの情報を取得する API です。
変更履歴
- 2019年08月29日 APIの各エンドポイントをHTTPSに対応し、それまでのエンドポイントは非推奨とした
- 2019年03月04日 ブックマーク追加・変更機能において、日本語のタグと半角英数字のタグを両方含むブックマークに失敗する問題を修正
- 2013年08月29日 リリース