はてなブックマークエントリー情報取得API
本ドキュメントに関する注意事項
本ドキュメントははてなブックマークにおけるエントリー情報を取得するAPI実装を解説するものです。
API使用の解説
https://b.hatena.ne.jp/entry/json/任意のURL
(この任意のURL では #
を %23
にエスケープする必要があります) を GET リクエストで送信することにより、JSON 形式でデータを取得することができます。
例:) https://b.hatena.ne.jp/entry/json/http://www.hatena.ne.jp/
例:) https://b.hatena.ne.jp/entry/json/?url=https%3A%2F%2Ffanyv88.com%3A443%2Fhttp%2Fwww.hatena.ne.jp%2F
また https://b.hatena.ne.jp/entry/json/
に対し、以下のクエリーパラメータを GET リクエストで送信することで、JSONP によるコールバック関数で囲まれたJSONデータを取得することができます。
url
URLをエスケープした文字列
callback
コールバック関数名。コールバック関数名は /^\$?[a-zA-Z0-9\[\]\.\_]+$/
(perl) の正規表現に一致する関数名でなくてはなりません。
例:) https://b.hatena.ne.jp/entry/json/?url=https%3A%2F%2Ffanyv88.com%3A443%2Fhttp%2Fwww.hatena.ne.jp%2F&callback=funcname
情報を絞り、より高速なレスポンスの API
/entry/json/
エンドポイントの代わりに /entry/jsonlite/
エンドポイントを利用することで、関連エントリー(related) 情報を返却しない代わりにより高速なレスポンスで返却する /entry/jsonlite/
API があります。
関連エントリーの情報を利用しない場合は、より高速なこちらの API をご利用ください。
例:) https://b.hatena.ne.jp/entry/jsonlite/?url=https%3A%2F%2Ffanyv88.com%3A443%2Fhttp%2Fwww.hatena.ne.jp%2F
例:) https://b.hatena.ne.jp/entry/jsonlite/?url=https%3A%2F%2Ffanyv88.com%3A443%2Fhttp%2Fwww.hatena.ne.jp%2F&callback=funcname
JSON データの構造
JSON データの構造は以下のようになっています。