Yahoo!オークション 商品検索 リクエストの作成
リクエストURLの作成
基本URLに検索したいパラメータを追加していけば、URLを作成することができます。作成したURLをブラウザに入力すれば応答が返ってくるので、正常に動作しているか確認することができます。
関連ページ XML構造 サンプルコード
サンプル リクエストURL
http://auctions.yahooapis.jp/AuctionWebService/V1/Search? appid=YahooDemo&query=web
「web」というキーワードで検索するURLです。「YahooDemo」にはアプリケーションIDを入れます。サンプルURLは改行されていますが、実際には改行せずに使用します。
リクエストURLをブラウザに入力し、次のように表示されれば正常に動作しています。
ブラウザで確認する
10,000円未満の商品を指定する場合
上記のURLに 「&aucmaxprice=10000」 を付け足します。
このようにパラメータを追加することで、検索条件を追加することができます。
バリューコマースアフィリエイト方法
バリューコマースアフィリエイト方法については、アフィリエイト方法を参照下さい。
リクエストパラメータ
リクエストパラメータの一覧です。ここからのコピー
コードに関しては、サンプルコードで説明しています。
| パラメータ | 値 | 説明 |
|---|---|---|
| appid（必須） | string | アプリケーションID。登録方法へ |
| query（必須） | string | （UTF-8エンコードされた）検索キーワードを指定します。 |
| type | string: all（デフォルト）,any | 指定検索の種類:
|
| category | integer | 取得したいYahoo!オークションのカテゴリIDを指定します。最上位のカテゴリの場合は0を指定します。（categoryパラメータがない場合も最上位カテゴリのリクエストとみなします） |
| page | integer:1（デフォルト） | 検索結果のページ番号の指定です。指定のない場合は1ページ目のリクエストとみなします。 |
| aucminprice | integer | 商品価格の範囲指定の下限値です。指定のない場合は下限値指定なしとみなします。 |
| aucmaxprice | integer | 商品価格の範囲指定の上限値です。指定のない場合は上限値指定なしとみなします。 |
| aucmin_bidorbuy_price | integer | 希望落札価格の範囲指定の下限値です。指定のない場合は下限値指定なしとみなします。 |
| aucmax_bidorbuy_price | integer | 希望落札価格の範囲指定の上限値です。指定のない場合は上限値指定なしとみなします。 |
| aucmin_buynow_price | integer | 即買価格の範囲指定の下限値です。指定のない場合は下限値指定なしとみなします。 |
| aucmax_buynow_price | integer | 即買価格の範囲指定の上限値です。指定のない場合は上限値指定なしとみなします。 |
| loc_code | integer: 1～48 | 地域コードです。1:北海道～48:海外の指定が可能です。指定のない場合はすべての商品になります。 |
| store | integer: 0（デフォルト）,1,2 | 商品の出品区分の絞り込み指定です。 0:すべての商品 1:オークションストアの出品 2:一般の出品者の出品 |
| escrow | integer: 1 | 受け取り後決済サービスの利用可能な商品の絞り込み指定です。指定のない場合はすべての商品になります。 |
| easypayment | integer: 1 | Yahoo!かんたん決済の利用が可能な商品の絞り込み指定です。指定のない場合はすべての商品になります。 |
| new | integer: 1 | newアイコンのついた商品の絞り込み指定です。指定のない場合はすべての商品になります。 |
| largeimg | integer: 1 | 特大画像付きの商品の絞り込み指定です。指定のない場合はすべての商品になります。 |
| freeshipping | integer: 1 | 送料無料の商品の絞り込み指定です。指定のない場合はすべての商品になります。 |
| wrappingicon | integer: 1 | 贈答品向き商品の絞り込み指定です。指定のない場合はすべての商品になります。 |
| buynow | integer: 1 | 即買商品の絞り込み指定です。指定のない場合はすべての商品になります。 |
| thumbnail | integer: 0（デフォルト）, 1 | 画像ありの商品の絞り込み指定です。指定のない場合はすべての商品になります。 |
| attn | integer: 0（デフォルト）, 1 | 注目のオークションの商品の絞り込み指定です。指定のない場合はすべての商品になります。 |
| gift_icon | integer: 0（デフォルト）～8 | 目立ちアイコンのついた商品の絞り込み指定です。 0: 指定なし 1: 新品 2: 美品 3: 非売品 4: 限定品 5: 保証書付 6: 全巻セット 7: 正規店購入 8: 産地直送 指定のない場合はすべての商品になります。 |
| sort | string: 右記参照 | 商品リストのソート項目の指定です。指定のない場合は終了時間の昇順（近い順）になります。ただし、その商品リストに「注目のオークション」がある場合は、「注目のオークション（注目のオークション利用料の金額の降順）」「すべてのオークション（終了時間の昇順）」の順となります。 img: 画像の有無 item : タイトル cbids: 現在価格 bids : 入札数 end : 終了時間 |
| order | string: a（デフォルト）, d | 上記のソートの順序の指定です。 a: 昇順 d: 降順 ※注 img、bidsのみaが降順、dが昇順となります。 |
