Tag API
Tag API は、WEBページの内容から、ワードリストを抽出しタグクラウドの基になるXMLデータを返します。
仕様
辞書エンジン
mecabとjumandicを使ってワードを抽出し、独自のアルゴリズムで用語を抽出しています。
下記にも説明しますが、<rate>に指定される値は必ず3未満になります。
リクエストURL
http://biyou.grandcross.net/api/tag/getList
リクエストパラメータ
「*」印は必須項目です。
パラメータ 値 説明 apikey* string このサービスを使う際に必要なAPI KEYです。
API KEYは取得はこちらからできます。url* string http://から始まるURLをエンコードした値です。
例) http%3A%2F%2F
biyou.grandcross.net%2FsiteChar string: [utf8|eucjp|sjis] (デフォルト utf8) サイトの文字コードを指定してください。 tagChar string: [utf8|eucjp|sjis] (デフォルト utf8) APIが返すタグ文字の文字コードを指定してください。 offset integer: (デフォルト 1) 表示開始タグの位置を指定します。 limit integer: (デフォルト 100) 表示件数を指定します。 sort string: [ASC(昇順):DESC(降順)] (デフォルト 未指定) レート数値で昇順・降順のソートをします。 search string: (デフォルト http://biyou.grandcross.net
/search/URLエンコードされたタグ名/)タグ名使って検索するURLを指定します。
例) http://biyou.grandcross.net
/search/%s/
タグ文字を埋め込みたい箇所に%sを指定してください
レスポンス
デフォルトのレスポンス文字コードは「UTF-8」です。
フィールド 説明 ResultSet 全てのレスポンスを含みます。下記の属性を持ちます。
・total: タグリストの合計数です。
・offset: 表示開始のポジションです。デフォルトは1です。
・limit: 合計の表示件数です。デフォルトは１００件てです。
item 個別のワード(word)とレート(rate)と検索用リンク(link)を持っています。 word 抽出されたワードを持っています。 rate レートを持っています。値は3未満です。 link 検索用リンクを持っています。 errors エラーメッセージを持っています。
キャッシュ
リクエストURL毎で結果をキャッシュするようにしています。 キャッシュ期間（lifetime）は、1 weekの設定になっています。 キャッシュを削除する場合は、URLの最後に&cleanを付けてください。 サーバーのリソースの問題上、&cleanは例外的に使用して下さい。
結果XMLサンプル
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet total="200" offset="1" limit="2">
<item>
<word>zend</word>
<rate>1.1111</rate>
<link>http://biyou.grandcross.net/search/zend/</link>
</item>
<item>
<word>php</word>
<rate>2.2222</rate>
<link>http://biyou.grandcross.net/search/php/</link>
</item>
<errors />
</ResultSet>
デモ
フォームに記入してデモ動作を確認してください。