はてなブックマークエントリー情報取得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=http%3A%2F%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=http%3A%2F%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=http%3A%2F%2Fwww.hatena.ne.jp%2F
例:) https://b.hatena.ne.jp/entry/jsonlite/?url=http%3A%2F%2Fwww.hatena.ne.jp%2F&callback=funcname
JSON データの構造
JSON データの構造は以下のようになっています。