リクエストパラメータ -商品検索API (Ver 3.1)

パラメータ名 必須 説明 備考
accesskey アクセスキー アクセスキーを取得する
version バージョン APIのバージョンを指定する
3.0: Ver 3.0 のインタフェースを使う※2
3.1: Ver 3.1 のインタフェースを使う
mode 出力モード レスポンスの出力形式を指定する
xml: XML形式でレスポンス※2
php: PHPシリアライズ形式でレスポンス
cat_tree カテゴリツリー同時取得 検索条件にマッチした商品のカテゴリツリーを同時取得する
off: 同時取得しない※2
on: 同時取得する
delv_pref 配送先指定 配送先都道府県コードを指定する
都道府県コード一覧
sword ※1 キーワード UTF-8でURLエンコードが必要
target   対象 all:商品名+商品説明 ※2
name:商品名
shop:ショップ名
category_id ※1 カテゴリID
shop_id ※1 ショップID
product_id ※1 商品ID
sales ※1 セール商品指定 0:全て ※2
1:リクエスト実行時にセール期間中の商品のみ
fee_up ※1 報酬UP商品指定 0:全て ※2
1:報酬UP商品のみ
stock 在庫あり商品指定 0:全て ※2
1:在庫あり商品のみ
sort_mode ソート条件
複数指定可※4
0:最新順 ※2
1:登録順
2:販売価格が安い順
3:販売価格が高い順
4:割引率が低い順
5:割引率が高い順
6:報酬率が低い順
7:報酬率が高い順
8:セール開始日が早い順
9:セール開始日が遅い順
10:送料(最高)込み価格が安い順
11:送料(最高)込み価格が高い順
12:送料(最低)込み価格が安い順
13:送料(最低)込み価格が高い順
14:送料無料条件があるものを優先
15:人気がある順(注文数)
New!
16:支払合計額が安い順 ※5-1
New!
17:支払合計額が高い順 ※5-1
offset 1ページあたりの取得件数 1~100までを半角数字で指定
(指定しない場合は20)
page ページ番号 1以上を半角数字で指定
(指定しない場合は1)
browser ブラウザ種別 pc:PC用
(指定しない場合はPC用)
mobile:モバイル用
both:両方 ※3
New!
price_target
  価格範囲の対象 0:現在の販売価格(セール期間内はセール価格)※2
1:通常の販売価格(セール状況を考慮しない)
2:支払合計額 ※5-2
category_id ※1 カテゴリID
price_min 価格範囲の下限 0以上を半角数字で指定
price_max 価格範囲の上限 0以上を半角数字で指定
fee_min 報酬範囲の下限 0~100までを半角数字で指定
fee_max 報酬範囲の上限 0~100までを半角数字で指定
sales_min 割引率範囲の下限 0~100までを半角数字で指定
sales_max 割引率範囲の上限 0~100までを半角数字で指定
time_sales_start セール開始日 年月日を8桁の半角数字で指定

※1.ワード・カテゴリID・ショップID・商品ID・セール商品・報酬UP商品のいずれかが必須
セール商品・報酬UP商品は 1 の指定をした時有効

※2.パラメータを指定しなかった時のデフォルト値

※3.レスポンスパラメータにPC・モバイル両方の商品名・リンクURLを出す

※4.先に指定したものから優先して適用
sort_mode=2-5 のように、半角ハイフン(-)で区切る

※5.リクエストパラメータ 配送先指定[delv_pref] を指定している時のみ有効
  5-1.配送先を指定していない場合はデフォルト値の [0:最新順] が替わりに適用されます
  5-2.商品を単品で注文した場合に最低限必要になる金額が対象になります
      ※商品単価(セール時はセール価格)+送料(無料条件の判定あり)

質問・要望はコチラ

リクエストパラメータ -商品検索API (Ver 3.1) への2件のフィードバック

  1. ピンバック: Ver 3.1 稼働開始! | 【電脳卸ウェブサービス】DWS3.0

  2. ピンバック: 商品を購入する時に最低限必要な金額がわかるようになりました! | 【電脳卸ウェブサービス】DWS3.0

コメントを残す

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です