Hatena Blog Tags

はてなスターカウントAPI

(はてな)
はてなすたーかうんとえーぴーあい


このページは古い情報を掲載しています

このページの情報は更新されていません。新しい情報は「はてなスターカウントAPI - Hatena Developer Center」に移転しました。

本ドキュメントは、はてなスターカウントAPIを解説するものです。主にはてなスタッフがその作成と更新を行っています。


はてなスターカウントAPIは「指定したブログのエントリに全部でいくつの☆がつけられているのか」という総数を取得できるAPIです。このAPIを利用して取得したデータは、そのまま自分のブログに表示したり、そのデータをほかのサービスに取り込んで利用したり、といったことが可能です。

はてなスターカウントAPIでは、取得したいブログのトップページのURIを、APIのURIに埋め込んで指定します。たとえば、「はてなスター日記(http://d.hatena.ne.jp/hatenastar/)」のデータを取得したい場合は、以下のようなURIにアクセスしてください。

http://s.hatena.ne.jp/blog.json/http://d.hatena.ne.jp/hatenastar/

このように「http://s.hatena.ne.jp/blog.json/」+「ブログのURI」が、それぞれのブログごとのカウントAPIのURIになっています。
このAPIが返すデータはJSON形式になっています。

{
  "title":"\u306f\u3066\u306a\u30b9\u30bf\u30fc\u65e5\u8a18",
  "star_count":"72464",
  "uri":"http://d.hatena.ne.jp/hatenastar/"
}

返ってくるオブジェクトには以下のようなプロパティが含まれています。

プロパティ名 内容
title ブログのタイトル
star_count そのブログにつけられた☆の総数
uri そのブログのURI

さらに、クエリパラメータとしてcallbackを渡すことで、JSONPとしてデータを取得できます。

http://s.hatena.ne.jp/blog.json/http://d.hatena.ne.jp/hatenastar/?callback=view_star

取得できるデータは以下のようなものになります。

view_star(
  {
      "title":"\u306f\u3066\u306a\u30b9\u30bf\u30fc\u65e5\u8a18",
      "star_count":"72464",
      "uri":"http://d.hatena.ne.jp/hatenastar/"
   }
);

これを利用することで、たとえば以下のように簡単に自分のページに現在の☆総数を表示することが可能です。

<script type="text/javascript">
function view_star(obj){
  document.write('ただいまの☆総数:'+obj.star_count);
}
</script>
<script type="text/javascript" src="http://s.hatena.ne.jp/blog.json/http://d.hatena.ne.jp/hatenastar/?callback=view_star">
このタグの解説についてこの解説文は、すでに終了したサービス「はてなキーワード」内で有志のユーザーが作成・編集した内容に基づいています。その正確性や網羅性をはてなが保証するものではありません。問題のある記述を発見した場合には、お問い合わせフォームよりご連絡ください。