オークション

出品リスト

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

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

特定のYahoo! JAPAN IDの出品者の出品リストを提供します。

リクエストパラメータ

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

パラメータ 説明
appid(必須) string アプリケーションID。詳細はこちらをご覧ください。
sellerID(必須) string 出品者のYahoo! JAPAN IDを指定します。
page integer:1(デフォルト) 商品リストのページ番号です。指定のない場合は1ページ目のリクエストとみなします。
easypayment integer: 1 Yahoo!かんたん決済の利用が可能な商品の絞り込み指定です。指定のない場合はすべての商品になります。
thumbnail integer: 0(デフォルト), 1 画像ありの商品の絞り込み指定です。指定のない場合はすべての商品になります。

サンプルリクエストURL

http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?appid=<あなたのアプリケーションID>&sellerID=<出品者のYahoo! JAPAN ID>


レスポンスフィールド

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

フィールド 説明
AuctionSellingList クエリーレスポンスのすべてを含み、次の属性を持ちます。
  • totalAuctions: この出品リスト内で条件に一致した商品(オークション)の総数です。
  • totalPage: この出品リスト内で条件に一致したページ総数です。
  • curPage: 現在のページ番号です。
seller 以下の出品者情報を含みます。
id この出品者のYahoo! JAPAN IDです。
itemlist この出品者の出品リストを取得するリクエストURLです。(appidは含まれていませんのでご注意ください)
about この出品者の自己紹介ページのURLです。
rating この出品者の評価のページのURLです。
item 以下の各商品(オークション)情報を含みます。
auctionID 商品(オークション)のIDです。
title 商品(オークション)のタイトルです。
url 商品詳細(オークション)ページのURLです。
img 画像(サムネイル)のURLです。
price 現在価格です。
bids 現在の入札数です。
endtime オークションの終了日時です。
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です。



サンプルレスポンス

以下は、sellerID=abc123456xyz のクエリーの結果です。

<?xml version="1.0" encoding="UTF-8" ?> 
<AuctionSellingList xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:jp:auc:sellinglist" xsi:schemaLocation="urn:yahoo:jp:auc:sellinglist http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList.xsd" totalAuctions="3" totalPage="1" curPage="1">
 <seller>
  <id>abc123456xyz</id> 
<itemlist>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=abc123456xyz</itemlist> 
  <about>http://user.auctions.yahoo.co.jp/jp/show/aboutme?userID=abc123456xyz</about> 
  <rating>http://rating5.auctions.yahoo.co.jp/jp/show/rating?userID=abc123456xyz</rating> 
 </seller>
 <item>
  <auctionID>x9876543</auctionID> 
  <title>【DVD】★2枚組BOX アニメーション abcdefg★</title> 
 <url>http://page10.auctions.yahoo.co.jp/jp/auction/x9876543</url> 
<img>http://img213.ac.yahoo.jp.zn8.net/img213.auctions.yahoo.co.jp/users/
4/4/1/4/abc123456xyz-thumb-1141310562
30265.jpg</img> 
  <price>1,400 円</price> 
  <bids>2</bids> 
  <endtime>3月 8日 21時 43分</endtime> 
  <option /> 
 </item>
 <item>
  <auctionID>v32654475</auctionID> 
  <title>【DVD】★3枚組BOX★xxxxxxxxxxxxxx★★</title> 
<url>http://page11.auctions.yahoo.co.jp/jp/auction/v32654475</url> 
<img>http://img141.ac.yahoo.jp.zn8.net/img141.auctions.yahoo.co.jp/users/
4/4/1/4/abc123456xyz-thumb-1141310653
72374.jpg</img> 
  <price>6,750 円</price> 
  <bids>5</bids> 
  <endtime>3月 8日 21時 47分</endtime> 
  <option /> 
 </item>
 <item>
  <auctionID>b7766554</auctionID> 
  <title>【DVD】★THE VERY BEST OF xxxxxxxxx #4★</title> 
  <url>http://page2.auctions.yahoo.co.jp/jp/auction/b7766554</url> 
<img>http://img173.ac.yahoo.jp.zn8.net/img173.auctions.yahoo.co.jp/users/
4/4/1/4/abc123456xyz-thumb-1141311404
1483.jpg</img> 
  <price>7,700 円</price> 
  <bids>7</bids> 
  <endtime>3月 8日 21時 57分</endtime> 
  <option /> 
 </item>
</AuctionSellingList>



エラー

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