はてなスターカウント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">