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(デフォルト)/ |
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. |
| 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の検索結果リストに含まれる。
