Amazon Webサービスを利用してAmazonのデータベースにアクセスするには指定の形式を使ってURIにアクセスします。ここではXSLTを使用する例で書いています。その指定の形式というのはamazon.co.jpなら
http://xml-jp.amznxslt.com/onca/xml3 ?以下使用するパラメーター
というような形式でAmazonのDBにアクセスする事になります。使用するパラメータは以下のようなものがあります。
mode は検索したい商品のジャンルなのですが、amazon.co.jpで利用できる商品ジャンルは以下となります。アメリカだとこれ以外にもアパレルとか宝石などといったものも取り扱っています。
↑が基本パラメータです。更にそれ以外にBrowse Node Search、Keyword Searchなどの検索タイプのパラメータを付加してAmazonにリクエストします。
検索タイプもたくさんあるのですが、ここでは主に使用することになるものを例にとってあげていきたいと思います。各検索は一部を除いて1頁に最大で10件表示となります。
Browse Node Search
各ジャンルごとの売れ筋検索になります。Amazonは大まかなジャンルはmusic-jpやdvd-jpなどのmodeで管理しています。更にそのジャンルの管理下に562032などのBrowse Node IDと呼ばれる番号で管理されています。例えばDVD日本映画だとmodeはdvd-jp、Browse Nodeは562014。デジカメならmodeはelectronics-jpでBrowse Nodeは3478221。輸入版CDはmode=music-jpでBrowse Nodeが564624といった具合です。Browse Node Searchで検索すると商品リストは売れている順番で返ってきます。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デベロッパ・トークン
&BrowseNodeSearch=ブラウズ番号
&mode=モード
&type=データタイプ
&locale=国番号
&page=頁
&f=XSLのURI
実際にリンクをしてみるとCDベストセラーとこんな感じになります。
ASIN/ISBN Search
商品に固有でついているASIN(Amazon Standard Item Number)、もしくは書籍についているISBNコードを使用してデータを取得します。商品の詳細情報ページ向けです。あらかじめASIN番号が分かってる場合に使用します。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デベロッパ・トークン
&AsinSearch=ASIN/ISBNコード
&type=データタイプ
&locale=国番号
&f=XSLのURI
こちらもサンプルサクラ大戦V ~さらば愛しき人よ~ 通常版。ちなみにASIN/ISBNコードは複数個記入できます。これはデータタイプに依存するのですが type=lite なら30商品、type=heavy なら10商品指定できます。複数個ASINを指定するのならば「AsinSearch=B00011D1V8,B0001GASQO」ってな感じて,で区切って記入してください。
Keyword Search
その名の通り指定語句検索です。一番よく使う検索タイプですね。指定したモード内の検索をします。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デベロッパ・トークン
&KeywordSearch=検索キーワード
&mode=モード
&sort=ソート順(option)
&page=頁
&locale=国番号
&type=データタイプ
&f=XSLのURI
試しに宇多田ヒカルでも検索してみましょう。これは注意事項なんですが検索キーワードがUTF8でエンコードして下さい。宇多田ヒカルなら「KeywordSearch=%E5%AE%87%E5%A4%9A%E7%94%B0%E3%83%92%E3%82%AB%E3%83%AB」といった具合になります。
Blended Search
Keyword Searchの場合は音楽やDVDなど指定したモード内の検索だったのですが、Blended Searchは全モードから検索します。検索結果は各モードへの検索リンクと3件づつ表示されます。当サイト配布のXSLTテンプレキットを使う場合のデフォルトの検索となります。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デベロッパ・トークン
&BlendedSearch=検索ワード
&locale=国番号
&type=データタイプ
&f=XSLのURI
いまいちパッとしなくなった浜崎あゆみを検索してみましょう。
主に使うのはこんなところでしょうか。でもWish ListとListmania Searchも頻繁にではないのだけど使用しますね。
Wish List Search
Amazonではウィッシュリストという欲しいものリストを作成できます。ウィッシュリストにも固有の番号があるのでそちらが分かればWebサービスを使用して表示する事が出来ます。自分のウィッシュリストIDはAmazonのアカウント頁から知ることが出来ます。ただしウィッシュリストを作成する時に自分でコメントも入力できるのですが、そのコメントはAWSでは取得する事が出来ません。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デべロッパ・トークン
&WishlistSearch=ウィッシュリストID
&page=頁
&locale=国番号
&type=データタイプ
&f=XSLのURI
Listmania! Searches
リストマニアは、おすすめ商品やお気に入りの商品をリストにして、amazonのサイト上で公開できるサービスです。こちらもWish List Searchと同じでリスト作成時に入力できるコメントは取得できません。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デベロッパ・トークン
&ListManiaSearch=リストマニアID
&page=頁
&locale=国番号
&type=データタイプ
&f=XSLのURI
紹介した以外にもまだまだ検索タイプはあります。そちらはざっと紹介。俺自身は使用した事のない検索タイプです。
Actor/Actress Searches
俳優・女優さん検索
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デベロッパ・トークン
&ActorSearch=俳優・女優名
&mode=モード
&locale=国番号
&type=データタイプ
&page=頁
&f=XSLのURI
Artist/Musician Searches
アーティスト・ミュージシャン検索
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デベロッパ・トークン
&ArtistSearch=アーティスト名
&mode=モード
&locale=国番号
&type=データタイプ
&page=頁
&f=XSLのURI
Author Searches
著者検索
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デベロッパ・トークン
&AuthorSearch=著者名
&mode=モード
&locale=国番号
&type=データタイプ
&page=頁
&f=XSLのURI
Director Searches
監督検索
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デベロッパ・トークン
&DirectorSearch=監督名
&mode=モード
&locale=国番号
&type=データタイプ
&page=頁
&f=XSLのURI
Manufacturer Searches
販売元検索
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デベロッパ・トークン
&ManufacturerSearch=販売元名
&mode=モード
&locale=国番号
&type=データタイプ
&page=頁
&f=XSLのURI
検索パラメーターは記事にする都合上改行して見やすくしています。実際にAmazonにリクエストする場合は改行とスペースを取っ払って1行にしてリクエストしてくださいね。じゃないと、エラーになって返ってきます。