[AWS3.0] Amazon Webサービス 3.0の検索種類を知ろう
Amazon Service 4.0が既に稼動している中で、今さら3.0での情報かよと思うかもしれませんがWebプログラミングを覚えるなら3.0の方がとっつきやすいと思いますので情報として残しておこうと思います。
Amazonへの検索リクエスト方法
RESTとSOAPといった方法でECSを利用したWebアプリを作成する事が出来ますが、当サイトではRESTを利用した方法を紹介していきます。まず最初にamazon.co.jpへのリクエストは
http://xml-jp.amznxslt.com/onca/xml3?以下使用するパラメーター
↑のような形式でAmazonのデータベースにアクセスすることになります。使用するパラメーターは主に以下のようなものがあります。
- t : アソシエイトID
- dev-t : サブスクリプションID
- type : データのタイプ(lite:簡易版、heavy:完全版)
- page : ページ番号
- mode : 検索する商品のジャンル
- f : XSLTスタイルシートのURI or xml
- sort : 並び替えの指定
- locale : 国コード。日本はjp
fパラメータにはXSLTスタイルシートのURLを指定します。XSLTを使わない場合はxmlと指定するとXML形式で検索データが取得できます。modeは検索商品のジャンルになります。amazon.co.jpでは以下のジャンルが今のところ用意されています。amazon.comだとこの他に宝石・アパレルなどがあったりします。
- 本 : books-jp
- 洋書 : books-us
- CD : music-jp
- クラシック : classical-jp
- DVD : dvd-jp
- ビデオ : vhs-jp
- エレクトロニクス : electronics-jp
- ソフトウェア : software-jp
- ゲーム : videogames-jp
- ホーム＆キッチン : kitchen-jp
- おもちゃ＆ホビー : toys-jp
以上が基本パラメーターになります。これに検索語句やブラウズノードなどを加えてAmazonのデーターベースにリクエストします。
検索タイプの種類を見てみよう
まず最初によく使う検索のタイプを見てみましょう。
ASIN and ISBN Searches
Amazonの商品についている固有の番号であるASIN(Amazon Standard Item Number)。もしくは書籍用の世界共通コードのISBNを利用して検索を行います。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&AsinSearch=ASIN/ISBNコード
&type=データタイプ
&locale=jp
&f=XSLTのURI or xml
JavaScript & DHTMLクックブック―Webエキスパート必携テクニック集のISBNコードで検索してみましょう。
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&AsinSearch=4873111692&locale=jp&type=heavy&f=xml
Blended Searches
Keyword Searchの場合は music-jp やdvd-jp など指定したモード内の検索だったのですが、Blended Searchは全モードから検索します。検索結果は各モードへの検索リンクと3件づつ表示されます。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&BlendedSearch=検索ワード
&locale=jp
&type=データタイプ
&f=XSLTのURI or xml
松平健で検索してみます。
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&BlendedSearch=%E6%9D%BE%E5%B9%B3%E5%81%A5&locale=jp&type=heavy&f=xml
Browse Node Searches
各ジャンルごとの売れ筋検索になります。Amazonは大まかなジャンルはmusic-jpやdvd-jpなどのモードで管理しています。更にそのジャンルの管理下に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=サブスクリプションID
&BrowseNodeSearch=ブラウズ番号
&mode=モード
&type=データタイプ
&locale=jp
&page=ページ
&f=XSLのURI or xml
音楽DVDの売れ筋商品を見てみます
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&BrowseNodeSearch=562018&mode=dvd-jp&locale=jp&type=heavy&f=xml
Keyword Searches
一番良く使われると思われるキーワード検索です。指定したモード内を検索します。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&KeywordSearch=検索キーワード(UTF形式でエンコード)
&mode=モード
&page=ページ
&locale=jp
&type=データタイプ
&f=XSLTのURI or xml
CDコーナーからGLAYを検索します。
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&KeywordSearch=glay&mode=music-jp&page=1&locale=jp&type=heavy&f=xml
Similarities Searches
Similarities Searchesは関連物検索です。商品Aを購入した時に同時に買った商品やシリーズ商品などのデータが蓄積され関連商品としてピックアップされます。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&SimilaritySearch=ASINコード
&locale=jp
&type=データタイプ
&page=ページ
&f=XSLTのURI or xml
宇多田ヒカルのBe My LastのSimilarities Searchesはこんな感じになります。
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&SimilaritySearch=B000A6BH3I&locale=jp&type=heavy&page=1&f=xml
あまり使わない検索モード
Actor/Actress Searches
俳優・女優さんの名前にて検索を行います。従って利用できるモードは vhs-jp か dvd-jpになります。なお商品に出演した全ての出演者が登録されているわけではないので、検索してもひかからない場合もあります。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&ActorSearch=俳優・女優名(UTF形式でエンコード)
&mode=dvd-jp or vhs-jp
&locale=jp
&type=データタイプ
&page=ページ
&f=XSLTのURI or xml
俳優の阿部寛のDVD出演作品を検索する場合は以下のようなパラメーターになります。
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&ActorSearch=%E9%98%BF%E9%83%A8%E5%AF%9B&mode=dvd-jp&locale=jp&type=heavy&page=1&f=xml
Artist/Musician Searches
アーティスト・ミュージシャンの名前で検索します。アーティスト検索なので使用できるモードは music-jp と classical-jp になります。こちらもアーティスト名が登録されているものしか検索できません。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&ArtistSearch=アーティスト名(UTF形式でエンコード)
&mode=モード
&locale=jp
&type=データタイプ
&page=ページ
&f=XSLTのURI or xml
aikoで検索する場合は以下のようになります。
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&ArtistSearch=aiko&mode=music-jp&locale=jp&type=heavy&page=1&f=xml
Author Searches
書籍の著者名で検索します。books-jp とbooks-us にて有効となります。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプション
&AuthorSearch=著者名(UTF形式でエンコード)
&mode=モード
&locale=jp
&type=データタイプ
&page=ページ
&f=XSLTのURI or xml
鳥山明で検索してみましょう
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&AuthorSearch=%E9%B3%A5%E5%B1%B1%E6%98%8E&mode=books-jp&locale=jp&type=heavy&f=xml
Director Searches
監督・ディレクター名で検索します。使用できるモードは dvd-jp と vhs-jp になります。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&DirectorSearch=監督・ディレクター名
&mode=モード
&locale=jp
&type=データタイプ
&page=ページ
&f=XSLTのURI or xml
宮崎駿で検索してみます。
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&DirectorSearch=%E5%AE%AE%E5%B4%8E%E9%A7%BF&mode=dvd-jp&locale=jp&type=heavy&f=xml
Listmania! Searches
リストマニアは、おすすめ商品やお気に入りの商品をリストにして、amazonのサイト上で公開できるサービスです。リストマニアのデータもAWSにて取得できます。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=デベロッパ・トークン
&ListManiaSearch=リストマニアID
&page=ページ
&locale=jp
&type=データタイプ
&f=XSLTのURI or xml
すてき！女性ボーカル！というリストマニアのデータを取得します。リストマニアIDはURIのlist-browse/-/339ALC7UK0W47/という部分の339ALC7UK0W47になります。
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&ListManiaSearch=339ALC7UK0W47&page=1&locale=jp&type=heavy&f=xml
Manufacturer Searches
メーカー・販売元検索です。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&ManufacturerSearch=販売元名
&mode=モード
&locale=jp
&type=データタイプ
&page=ページ
&f=XSLTのURI or xml
家電コーナーからSONYの商品を検索
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&ManufacturerSearch=sony&mode=electronics-jp&page=1&locale=jp&type=heavy&f=xml
Power Searches
書籍検索を細かく指定します。
http://xml.amazon.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&PowerSearch=検索語句
&mode=books-jp
&locale=jp
&type=データタイプ
&page=ページ
&f=XSLTのURI or xml
何か知らないが現時点(2005/9/4)でPower Serchをかけると日本語が化けてでてきて細かく検証できん。。。また後ほどアップします。
Wish List Search
Amazonではウィッシュリストという欲しいものリストを作成できます。ウィッシュリストにも固有の番号があるのでそちらが分かればWebサービスを使用して表示する事が出来ます。
http://xml-jp.amznxslt.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプション
&WishlistSearch=ウィッシュリストID
&page=ページ
&locale=jp
&type=データタイプ
&f=XSLTのURI or xml
ウィッシュリストのアドレスはhttp://www.amazon.co.jp/exec/obidos/registry/2JI77KUFPQxxx/のような感じになります。この場合は2JI77KUFPQxxxがウィッシュリストIDとなります。
http://xml-jp.amznxslt.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&WishlistSearch=2JI77KUFPQxxx&page=1&locale=jp&type=heavy&f=xml
Amazon.comのみで利用できる検索モード。
Exchange Searches
Amazon.Comのみで利用できます。Amazon.comだとサードパーティがAmazonブースを持って商品の販売を行えます。Exchange Searchesは出品商品の詳細を取得します。
http://xml.amazon.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&ExchangeSearch=Exchange ID
&type=データタイプ
&f=XSLTのURI or xml
z-shopにて出品されているSKYE SWEETNAMのNoise from the Basement [ENHANCED]を例にとって見ます。URIの
http://xml.amazon.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&ExchangeSearch=Y01Y3707405Y5869281&type=heavy&f=xml
Marketplace Searches
Amazon.comのみ？マーケットプレイスの検索です。
http://xml.amazon.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&MarketplaceSearch=keyword
&type=データタイプ
&page=ページ
&f=XSLTのURI or xml
更に以下のパラメータからいずれか
&keyword=[keyword goes here]
&keyword-search=[title or titledesc]
&browse-id=[browse ID goes here]
&zipcode=[ZIP code goes here]
&area-id=[area ID goes here]
&geo=[ship-to or ship-from]
マーケットプレイスからmoneyを含む商品を検索。
http://xml.amazon.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&MarketplaceSearch=keyword&f=xml&type=heavy&keyword=money&page=1
マーケットプレイスのComputer > Hardewareコーナのデータを取得
http://xml.amazon.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&MarketplaceSearch=keyword&f=xml&type=heavy&browse-id=69150&page=1
Seller Profile Search
Amazon.comのみで利用できます。サードパーティの評価やニックネームなどのメンバープロフィールを取得します。
http://xml.amazon.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&SellerProfile=セラーID
&type=データタイプ
&page=ページ
&f=XSLTのURI or xml
なぜかリファレンスの通りにやってもエラーがでます・・・。
Text Stream Searches
Amazon.comのみ利用可能。レビューなどからも含めて検索語句を検索する？
http://xml.amazon.com/onca/xml3
?t=アソシエイト ID
&dev-t=サブスクリプション ID
&TextStreamSearch=検索語句
&mode=モード
&type=データタイプ
&page=ページ
&f=XSLTのURI or xml
johnというキーワードで検索してみます。
http://xml.amazon.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&TextStreamSearch=john&mode=dvd&type=heavy&page=1&f=xml
Third-Party Seller Searches
Amazon.comのみで利用できます。サードパーティが出品している商品一覧を見ることが出来ます。
http://xml.amazon.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&SellerSearch=セラー ID
&type=データタイプ
&page=ページ
&offerstatus=open or closed
f=XSLTのURI or xml
セラーIDは商品の出品主のページで分かります。Shop tekateren。この例ですとURIのts/user-glance/A1M678WF4PMSTI/の部分のA1M678WF4PMSTIがセラーIDとなります。
http://xml.amazon.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]A&SellerSearch=A1M678WF4PMSTI&type=heavy&page=1&offerstatus=open&f=xml
UPC Searches
Amazon.comのみで利用できます。Universal Product Codeを利用して商品情報を取得する。UPC Codeは日本でいうところのJanコードみたいなものです。商品にバーコードとして張られています。UPCコードについて詳しくはビジネスリーダーの為のIT用語辞典をどうぞ。
http://xml.amazon.com/onca/xml3
?t=アソシエイトID
&dev-t=サブスクリプションID
&UpcSearch=UPCコード
&mode=モード
&type=データタイプ
&f=XSLTのURI or xml
The Best of Three Dog NightというCDをUPCコードで検索してみる。
http://xml.amazon.com/onca/xml3?t=[Your Associates ID]&dev-t=[Your Subscription ID]&UpcSearch=076732601822&mode=music&type=heavy&f=xml(注) 2008年3月でAWS 3.0は終了となり、ECS 4.0へ切り替わりました。
コメント