はてなブックマーク日記

(開発者さま向け) 特定サイトの被はてなブックマーク数を取得する XML-RPC API の公開について

15:42 |

はてなブックマークカウンターの公開に合わせて、特定サイトの被はてなブックマーク数の合計値を取得する XML-RPC API を公開しました。任意の URL を指定すると、その URL の被ブックマーク件数が返却される API です。

APIエンドポイント

http://b.hatena.ne.jp/xmlrpc

XML-RPCメソッド名

bookmark.getTotalCount

引数

件数を取得したいURLを指定(複数指定不可)

このAPIを用いてやり取りを行った場合のサンプルは以下のようになります。

リクエスト

<?xml version="1.0"?>
<methodCall>
  <methodName>bookmark.getTotalCount</methodName>
  <params>
    <param>
      <value><string>http://d.hatena.ne.jp/hatenadiary/</string></value>
    </param>
  </params>
</methodCall>

レスポンス

<?xml version="1.0"?>
<methodResponse>
  <params>
    <param>
      <value><int>5268</int></value>
    </param>
  </params>
</methodResponse>

サンプルコード (Perl)

本 API を用いて件数を取得する Perl のサンプルコードは以下のようになります。

#!/usr/local/bin/perl
use strict;
use warnings;
use XMLRPC::Lite;

my $url = shift or die "usage $0 <url>";
our $EndPoint = 'http://b.hatena.ne.jp/xmlrpc';

my $count = XMLRPC::Lite
    ->proxy($EndPoint)
    ->call('bookmark.getTotalCount', $url)
    ->result;

print $count, "\n";

本スクリプトの引数に URL を与えて実行すると、

% perl get_all_count.pl http://d.hatena.ne.jp/hatenadiary/
5268

と被ブックマーク件数が出力されます。どうぞご利用ください。