はてなブックマーク件数取得API
本ドキュメントに関する注意事項
本ドキュメントははてなブックマークにおける件数取得のAPI実装を解説するものです。
GET リクエストでのシンプルなAPI
GET リクエストでのシンプルな件数取得 API です。
https://bookmark.hatenaapis.com/count/entry?url=http%3A%2F%2Fwww.hatena.ne.jp%2F
のように https://bookmark.hatenaapis.com/count/entry の API エンドポイントにクエリパラメー タ url を付与し GET リクエストを送ることで、簡単にカウント数を取得することができます。
また、callback クエリパラメータを付与することで、JSONP でカウント件数を取得することも可能です。
https://bookmark.hatenaapis.com/count/entry?url=http%3A%2F%2Fwww.hatena.ne.jp%2F&callback=MyCallbackFunction
GET リクエストでのシンプルな API（複数 URL 版）
GET リクエストでのシンプルな件数取得 API の、複数 URL 対応版です。
https://bookmark.hatenaapis.com/count/entries?url=http%3A%2F%2Fwww.hatena.ne.jp%2F&url=http%3A%2F%2Fb.hatena.ne.jp%2F
のように https://bookmark.hatenaapis.com/count/entries の API エンドポイントにクエリパラメータ url を複数付与し GET リクエストを送ることで、複数の URL に対するブックマーク数を一度に取得できます。応答は URL をキー、ブックマーク数を値とした JSON 形式となります。
{"https://www.hatena.ne.jp/":5790,"https://b.hatena.ne.jp/":6793}
一度に指定できる url の数は 50 までです。これを越えると 414 Request-URI Too Large が返却されます。
1 URL に対する API の場合と同様に、callback パラメータを指定することで、JSONP も利用できます。
https://bookmark.hatenaapis.com/count/entries?url=http%3A%2F%2Fwww.hatena.ne.jp%2F&url=http%3A%2F%2Fb.hatena.ne.jp%2F&callback=MyCallbackFunction
ご利用にあたっての注意事項
- 実験的に公開されている API は、仕様の変更ならびに API の公開停止を予告なしに行う場合があります。
- API へのリクエストに際して、1クライアントあたりの上限回数はいまのところありません。ただし、過度なリクエストはサーバーの過負荷ならびにサービスのレスポンス低下に繋がりますので、繰り返しリクエストされる場合は、リクエスト毎に数秒の間隔をあけていただくなど、サーバーリソースの節約にご協力ください。
参照
変更履歴
- 2020年06月10日 廃止済の被ブックマーク合計数取得APIおよび旧ドメインについての記述を削除しました
- 2019年08月29日 各エンドポイントをHTTPSに対応し、それまでのエンドポイントは非推奨とした
- 2018年06月27日 XML-RPC API を廃止
- 2018年06月05日 GETリクエストでのシンプルなAPI（被ブックマーク合計数取得API）を追加
- 2013年09月10日 GETリクエストでのシンプルなAPI（複数URL版）を追加
- 2009年08月11日 GETリクエストのシンプルなAPIを追加
- 2006年10月04日 被ブックマーク合計数取得APIを追加
- 2005年12月20日 被コレクション件数取得APIを追加
- 2005年12月12日 リリース