オークション

商品リスト

リクエストURL
XML
http://auctions.yahooapis.jp/AuctionWebService/V1/CategoryLeaf

こちらのAPIは、2015年4月15日に終了させていただきました。最新バージョンのAPIをご利用ください。

ヤフオク!の商品リストを提供します。

リクエストパラメータ

RESTリクエストの構築(GET)」および、「RESTリクエストの構築(POST)」をご参照ください。

パラメータ 説明
appid(必須) string アプリケーションID。詳細はこちらをご覧ください。
category(必須) integer 商品リストのカテゴリIDを指定します。
page integer:1(デフォルト) 商品リストのページ番号です。指定のない場合は1ページ目のリクエストとみなします。
aucminprice integer 商品価格の範囲指定の下限値です。指定のない場合は下限値指定なしとみなします。
aucmaxprice integer 商品価格の範囲指定の上限値です。指定のない場合は上限値指定なしとみなします。
store integer: 0(デフォルト),
1,2
商品の出品区分の絞り込み指定です。
0:すべての商品
1:オークションストアの出品
2:一般の出品者の出品
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: 降順

サンプルリクエストURL

http://auctions.yahooapis.jp/AuctionWebService/V1/CategoryLeaf?appid=<あなたのアプリケーションID>&category=<商品リストのカテゴリID>


レスポンスフィールド

商品リストのスキーマの記述は、以下のURLをご覧ください。
http://auctions.yahooapis.jp/AuctionWebService/V1/CategoryLeaf.xsd

フィールド 説明
AuctionCategoryLeaf クエリーレスポンスのすべてを含み、次の属性を持ちます。
  • totalFAuctions: この商品リスト(カテゴリリーフ)内で条件に一致した注目の商品(オークション)の総数データ内のマッチしたクエリー数です。
  • totalAuctions: この商品リスト(カテゴリリーフ)内で条件に一致した商品(オークション)の総数
  • totalPage: この商品リスト(カテゴリリーフ)で条件に一致したページ総数
  • curPage: 現在のページ番号
  • categoryPath: この商品リスト(カテゴリリーフ)のパス
item 以下の各商品(オークション)情報を含みます。
auctionID 商品(オークション)のIDです。
title 商品(オークション)のタイトルです。
seller 出品者に関する情報です。
id 出品者のYahoo! JAPAN IDです。
itemlist この出品者の出品リストを取得するリクエストURLです。(appidは含まれていませんのでご注意ください)
rating この出品者の評価のページのURLです。
url 商品詳細(オークション)ページのURLです。
img 画像(サムネイル)のURLです。
price 現在価格です。
bids 現在の入札数です。
endtime オークションの終了日時です。
bidorbuy 希望落札価格です。(設定されていない場合は要素なし)
reserved 最低落札価格の有無です。(設定されていない場合は要素なし)
option 商品(オークション)にオプションが設定されている場合、そのオプションのアイコン(GIFファイル)のURLを示します。
new 「new」アイコンのURLです。
store 「ストア」アイコンのURLです。
check 「鑑定済み」アイコンのURLです。
public 「公売」アイコンのURLです。
freeshipping 「送料無料」のアイコンのURLです。
wrappingicon 「贈答品」アイコンのURLです。
buynow 「即買」アイコンのURLです。
easypayment 「Yahoo!かんたん決済」アイコンのURLです。
largeimg 「特大画像」アイコンのURLです。
gift_icon 「目立ち」アイコンのURLです。



サンプルレスポンス

以下は、category=2084044805 のクエリーの結果です。

<?xml version="1.0" encoding="UTF-8" ?>
<AuctionCategoryLeaf xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:jp:auc:leaf" xsi:schemaLocation="urn:yahoo:jp:auc:leaf http://auctions.yahooapis.jp/AuctionWebService/V1/CategoryLeaf.xsd" totalFAuctions="69" totalAuctions="461" totalPage="11" curPage="1" categoryPath="オークション > コンピュータ > パーソナルコンピュータ > Windows > デスクトップ > Pentium 4">
 <item>
  <auctionID>x12345678</auctionID> 
  <title>★★Pentium4 530 1GB 16倍速DVD±R/DL/RW★★</title> 
  <seller>
   <id>aaaaa123456789</id> 
<itemlist>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=aaaaa123456789</itemlist> 
   <rating>http://rating8.auctions.yahoo.co.jp/jp/show/rating?userID=aaaaa123456789</rating> 
  </seller>
<url>http://page14.auctions.yahoo.co.jp/jp/auction/x12345678</url> 
<img>http://a1025.lm.a.yimg.com/7/1025/1783/000/bag05pr000.ac.yahoo.co.jp/
users/7/5/3/5/aaaaa123456789-thumb-1141742409244944.jpg</img> 
  <price>7,950 円</price> 
  <bids>10</bids> 
  <endtime>3月 9日 22時 40分</endtime> 
  <option>
  <new>http://image.auctions.yahoo.co.jp/i/auctions/new3.gif</new> 
 <store>http://image.auctions.yahoo.co.jp/images/premium.gif</store>
<easypayment>http://i.yimg.jp/images/pay/icon_s16.gif</easypayment>
<gift_icon>http://a1017.lm.a.yimg.com/7/1017/1783/000/image.auctions.yahoo.co.jp/images/gift/
c_attention_05.gif</gift_icon> 
  </option>
 </item>
 <item>
  <auctionID>x88888789</auctionID> 
  <title>★ABC DEF 静音 P4/1.7 新品同様!★</title> 
  <seller>
   <id>z1b2c3d4e5f6789</id> 
<itemlist>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=z1b2c3d4e5f6789</itemlist> 
   <rating>http://rating6.auctions.yahoo.co.jp/jp/show/rating?userID=z1b2c3d4e5f6789</rating> 
  </seller>
 <url>http://page2.auctions.yahoo.co.jp/jp/auction/x88888789</url> 
<img>http://ac.c.yimg.jp/7/1026/1783/000/img217.auctions.yahoo.co.jp/users/5/6/2/6/
z1b2c3d4e5f6789-thumb-114172473691401.jpg</img> 
  <price>10 円</price> 
  <bids>5</bids> 
  <endtime>3月 9日 23時 58分</endtime> 
  <bidorbuy>39,800 円</bidorbuy> 
  <option>
  <new>http://image.auctions.yahoo.co.jp/i/auctions/new3.gif</new> 
<gift_icon>http://a1017.lm.a.yimg.com/7/1017/1783/000/image.auctions.yahoo.co.jp/images/gift/
c_attention_02.gif</gift_icon> 
  </option>
 </item>
 <item>
   <auctionID>y88881234</auctionID> 
  <title>■HDD 新品60G メモリー256MB CD-RW ABC 1234-5AZ■</title> 
   <seller>
    <id>zzz123yyyxxx</id> 
<itemlist>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=zzz123yyyxxx</itemlist> 
    <rating>http://rating6.auctions.yahoo.co.jp/jp/show/rating?userID=zzz123yyyxxx</rating> 
   </seller>
  <url>http://page.auctions.yahoo.co.jp/jp/auction/y88881234</url> 
<img>http://a1018.lm.a.yimg.com/7/1018/1783/000/img145.auctions.yahoo.co.jp/users/
5/0/6/2/zzz123yyyxxx-thumb-114172356823229.jpg</img> 
   <price>11,500 円</price> 
   <bids>13</bids> 
   <endtime>3月 9日 23時 59分</endtime> 
   <option>
  <new>http://image.auctions.yahoo.co.jp/i/auctions/new3.gif</new> 
<easypayment>http://i.yimg.jp/images/pay/icon_s16.gif</easypayment> 
   </option>
 </item>

 (以下 <item>要素繰り返し)

</AuctionCategoryLeaf>



エラー

商品リストはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。