Hatena::Grouphatena

はてなブックマーク日記 このページをアンテナに追加 RSSフィード

2006-10-04

(開発者さま向け) 特定サイトの被はてなブックマーク数を取得する 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

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

トラックバック - http://hatena.g.hatena.ne.jp/hatenabookmark/20061004