iYappo > YWS
Web API
YWSのWeb APIの説明です。

Web APIの戻り値はOpenSearchに準拠したRSS 2.0のデータです。
URL http://api.yws.yappo.jp/search
Method GET
Parameter ap: API KEY
ip: クライアントのIPアドレス
ua:クライアントのUser Agent
k: 検索キーワード
s: 表示開始位置
戻り値 A9 OpenSearchフォーマット

検索結果をユーザーに表示するときに、<link>要素のURLの直接アクセスするように作りこんで下さい。
Web API内部で、最大2回のRedirect処理を行ないますので、<link>要素を直接Aタグなどに既述しないと、一部の端末でアクセス出来なくなる可能性が有ります。


※注意1:ipとuaを詐称されますと、検索結果のサイトに正しくアクセス出来なくなる事が有ります
※注意2:広告を挿入する関係で、表示開始位置を指定されますと表示開始位置の精度が落ちます

検索結果データは、基本的にRSS2.0になっています。
ページヒット数や、現在のページカーソル等はOpenSearchの拡張を使用しています。
本家のOpenSearchの説明はこちら
それぞれのパラメータは下記の通り
openSearch:totalResults キーワードに一致したサイトの数
openSearch:startIndex 取得開始位置
openSearch:itemsPerPage 検索結果件数

iYappoV9
©Yappo 1997-2005