Yahoo!ショッピング 商品検索 リクエストの作成

リクエストURLの作成

基本URLに検索したいパラメータを追加していけば、URLを作成することができます。作成したURLをブラウザに入力すれば応答が返ってくるので、正常に動作しているか確認することができます。
関連ページ XML構造 サンプルコード

サンプル リクエストURL

http://shopping.yahooapis.jp/ShoppingWebService/V1/itemSearch?
appid=YahooDemo&query=web

「web」というキーワードで検索するURLです。「YahooDemo」にはアプリケーションIDを入れます。サンプルURLは改行されていますが、実際には改行せずに使用します。
リクエストURLをブラウザに入力し、次のように表示されれば正常に動作しています。
ブラウザで確認する

10,000円未満の商品を指定する場合

上記のURLに 「&price_to=10000」 を付け足します。
このようにパラメータを追加することで、検索条件を追加することができます。

アフィリエイトID

バリューコマース アフィリエイトID 【vc】 Yahoo! JAPAN アフィリエイトID 【yid】を参照下さい。

リクエストパラメータ

リクエストパラメータの一覧です。ここからのコピー
コードに関しては、サンプルコードで説明しています。

パラメータ 説明
appid
(必須)
string アプリケーションID 登録方法へ
affiliate_type yid/vc Yahoo! JAPANアフィリエイト(yid)とバリューコマースアフィリエイト(vc)の選択。
例:affiliate_type=yid
affiliate_id string Yahoo! JAPANアフィリエイトIDもしくは、バリューコマースアフィリエイトIDを入力。
バリューコマース アフィリエイトIDの説明
Yahoo! JAPAN アフィリエイトIDの説明
callback string JSONPとして出力する際のコールバック関数名を入力する為のパラメータ。UTF-8でエンコードした文字列を入力する。
query
(※1必須)
string キーワード検索。(UTF-8エンコードされた文字列をご利用下さい。)
例:query=vaio
type all(デフォルト)/any allは全クエリー文字を含む検索結果を返します。anyはクエリー文字のうちいずれかを含む検索結果を返します。
jan
(※1必須)
integer JANコードによって商品を検索。
isbn
(※1必須)
integer ISBNコード(書籍コード)によって商品を検索。
category_id
(※1必須)
integer カテゴリIDによる商品の絞り込み検索。
カテゴリIDリストは、カテゴリID取得APIによって取得していただけます。
product_id
(※1必須)
integer 製品IDによる商品検索。
※2
person_id
(※1必須)
integer 人物IDによる商品検索。
※2
brand_id
(※1必須)
integer ブランドIDによる商品検索。
※2
store_id
(※1必須)
string ストアのID指定検索。
http://store.shopping.yahoo.co.jp/○○○○/index.html の○○○○を指定して商品を検索。
price_from integer
(デフォルト:0)
価格指定(最低価格)した価格以上を検索する。
例:price_from=1000
price_to integer 価格指定(最高価格)した価格未満を検索する。
例:price_to=10000
hits integer
(デフォルト:20)
取得する検索結果数。デフォルトは20、最大値は50。
offset integer 何件目から表示させるか(1件目は0)の設定。
sort price/name/
score/sold
(デフォルト:score)
price:商品価格
name:ストア名
score:おすすめ順
sold:売れ筋順
これらを指定して並べ替えを行う。
デフォルトはおすすめ順(他 商品価格 ストア名 売上順)-(降順)もしくは+(昇順)で並び順を指定。UTF-8にエンコードされている必要あり。
例:商品価格昇順 sort=%2Bprice
module priceranges/
subcategories
検索結果に含まれる、価格幅、サブカテゴリとサブカテゴリに含まれる商品数のリストを取得する。
例:module=subcategories 指定しない場合は無視。
availability 1 在庫絞り込み。
指定しない場合は在庫状況を無視。
例:在庫有 availability=1
discount 1 セール中商品絞り込み。
1以外の指定は無視。 discount=1
shipping 1 デフォルトは設定なし。 shipping=1が送料無料。

※1.リクエストの際にいずれかを指定する必要あり。
※2.製品ID、人物ID、ブランドIDは、商品検索APIの検索結果リストに含まれる。

ホームページ WEBサービス API PHP プログラミング