オークション
出品リスト
- Version 1
- Version 2
リクエストURL
XML
http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList
こちらのAPIは、2015年4月15日に終了させていただきました。
特定の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?レスポンスフィールド
出品リストのスキーマの記述は、以下のURLをご覧ください。
http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList.xsd
フィールド | 説明 |
---|---|
AuctionSellingList | クエリーレスポンスのすべてを含み、次の属性を持ちます。
|
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に共通のエラーメッセージおよびコードを返します。