はてなスターカウントAPI

はてな

はてなスターカウントAPI

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

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

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

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

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

はてなスターカウントAPIでは、取得したいブログのトップページのURIを、APIURIに埋め込んで指定します。たとえば、「はてなスター日記(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」が、それぞれのブログごとのカウントAPIURIになっています。

この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">