マイ・オークション表示（出品終了分）

リクエストパラメータ

「RESTリクエストの構築（GET）」をご参照ください。

パラメータ	値	説明
start	integer	参照するページ番号を指定します。
list	string	sold ： 落札者ありの一覧を表示します。 not_sold ： 落札者なしの一覧を表示します。

※上記のパラメータ以外にOAuthのAuthorizationヘッダが必要になります。OAuthのAuthorizationヘッダについては、以下のサイトで詳細をご確認ください。
・OAuthのフロー
・OAuthを用いたAPIリクエスト
※Consumer Keyを取得する際に「マイ・オークション関連の機能」スコープを選択してください。スコープの詳細は、「スコープに関して」でご確認ください。

サンプルリクエストURL

http://auctions.yahooapis.jp/AuctionWebService/V2/myCloseList?start=<参照するページ番号>&list=<落札者ありなしの指定>
Authorization: OAuth 
realm="yahooapis.jp",
oauth_consumer_key=<お客様のConsumer Key>,
oauth_nonce=<ランダムな文字列>,
oauth_signature_method="HMAC-SHA1",
oauth_timestamp=<タイムスタンプ値>,
oauth_token=<トークン値>,
oauth_version="1.0",
oauth_signature=<シグネチャの内容>

レスポンスフィールド

マイ・オークション表示（出品終了分）Web APIのスキーマの記述は、以下のURLをご覧ください。
http://auctions.yahooapis.jp/AuctionWebService/V2/myCloseList.xsd

フィールド	説明
ResultSet	クエリーレスポンスのすべてを含み、次の属性を持ちます。 totalResultsAvailable：該当件数の総個数です。 totalResultsReturned：返された値の個数です。 firstResultPosition：最初のデータが何個目に当たるかです。
Result	各個別レスポンスを含みます。
AuctionID	オークションIDです。
Title	商品のタイトルです。
HighestPrice	落札価格です。¥記号やカンマは含みません。小数点第二位までの精度です。
Winner	落札者情報です。
Id	落札者のYahoo! JapanIDです。落札者が複数の場合、「落札者一覧」と表示されます。
ItemListUrl	落札者の出品リストを取得するリクエストURLです。（appidは含まれていませんのでご注意ください）。落札者が複数の場合、落札者一覧を取得するリクエストURLになります。
Message	取引情報です。
Title	取引の投稿タイトルです。 連絡先、支払い、発送などについて 入金を確認しました 商品を発送しました 送付先住所、支払い、発送などについて 支払いが完了しました 商品を受け取りました その他 のいずれかになります。（取引メッセージがなければ空）
ContributeIconUrl	落札者からメッセージが投稿された場合に付く「落札者」アイコンのURLです。出品者の取引メッセージである、または取引メッセージがなければ空
EndTime	終了予定日時です。RFC3339に準拠した表現を用います。（例：2004-04-01T12:00:00+09:00）
AuctionItemUrl	商品詳細のURLです。
Image	画像（サムネイル）の情報です。
Url	画像（サムネイル）のURLです。
Width	画像（サムネイル）の幅です。
Height	画像（サムネイル）の高さです。
Option	各オプションの設定状況です。
StoreIconUrl	ストア商品の場合ストアアイコンのURLが設定されます。
NewIconUrl	出品されてから間もない商品に付く「New」アイコンのURLです。
FeaturedIconUrl	注目のオークション設定アイコンのURLです。
CheckIconUrl	「鑑定済み」アイコンのURLです。
FreeShippingIconUrl	「送料無料」のアイコンのURLです。
WrappingIconUrl	「贈答品」アイコンのURLです。
BuynowIconUrl	「即買」アイコンのURLです。
EasyPaymentIconUrl	「Yahoo!かんたん決済」アイコンのURLです。
GiftIconUrl	「目立ち」アイコンのURLです。
ItemStatusNewIconUrl	「新品」アイコンのURLです。設定されていない場合は空。
YBankIconUrl	Yahoo!ネットバンキング対応の場合にYahoo!ネットバンキングアイコンのURLが設定されます。
StarClubIconUrl	「スタークラブ限定セール」アイコンのURLです。設定されていない場合は空。
PointIconUrl	「Yahoo!ポイント」アイコンのURLです。設定されていない場合は空
IsBold	太字の設定です。（あり：true　なし：false）
IsBackGroundColor	背景色の設定です。（あり：true　なし：false）

サンプルレスポンス

以下は、start=3 list=sold のクエリーの結果です。 <?xml version="1.0" encoding="UTF-8"?> <ResultSet totalResultsAvailable="220" totalResultsReturned="50" firstResultPosition="101"> <Result> <AuctionID>x12345678</AuctionID> <Title>商品名１</Title> <HighestPrice>123.00</HighestPrice> <Winner> <Id>hoge_hoge</Id> <ItemListUrl>http://api.auctions.yahoo.co.jp/AuctionWebService/V1/SellingList?sellerID=hoge_hoge</ItemListUrl> </Winner> <Message/> <EndTime>2004-04-08T12:00:00+09:00</EndTime> <AuctionItemUrl>http://pageX.auctions.yahoo.co.jp/jp/auction/x12345678</AuctionItemUrl> <Image> <Url>http://a1017.lm.a.yimg.com/7/1017/1783/000/f03batchimg.auctions.yahoo.co.jp/users/5/2/7/1/xxxxx-thumb-1208052000152677.jpg</Url> <Width>75</Width> <Height>75</Height> </Image> <Option> <StoreIconUrl>http://image.auctions.yahoo.co.jp/images/premium.gif</StoreIconUrl> <NewIconUrl/> <EscrowIconUrl/> <FeaturedIconUrl/> <CheckIconUrl/> <FreeShippingIconUrl>http://image.auctions.yahoo.co.jp/images/pstfree.gif</FreeShippingIconUrl> <WrappingIconUrl>http://image.auctions.yahoo.co.jp/images/gift.gif</WrappingIconUrl> <BuynowIconUrl>http://image.auctions.yahoo.co.jp/images/buynow.gif</BuynowIconUrl> <EasyPaymentIconUrl>http://img.yahoo.co.jp/images/pay/icon_s16.gif</EasyPaymentIconUrl> <GiftIconUrl>http://a1017.lm.a.yimg.com/7/1017/1783/000/image.auctions.yahoo.co.jp/images/gift/c_attention_04.gif</GiftIconUrl> <ItemStatusNewIconUrl/> <YBankIconUrl>http://i.yimg.jp/images/sicons/bank16.gif</YBankIconUrl> <EnglishIconUrl/> <StarClubIconUrl/> <PointIconUrl/> <IsBold>true</IsBold> <IsBackGroundColor>false</IsBackGroundColor> </Option> </Result> <Result> <AuctionID>x987654321</AuctionID> <Title>商品名２</Title> <HighestPrice>123.00</HighestPrice> <Winner> <Id>hoge_hoge</Id> <ItemListUrl>http://api.auctions.yahoo.co.jp/AuctionWebService/V1/SellingList?sellerID=hoge_hoge</ItemListUrl> </Winner> <Message> <Title>その他</Title> <ContributeIconUrl>http://i.yimg.jp/images/auct/template/ui/auc_mod/ic_6002.gif</ContributeIconUrl> </Message> <EndTime>2004-04-08T12:00:00+09:00</EndTime> <AuctionItemUrl>http://pageX.auctions.yahoo.co.jp/jp/auction/x987654321</AuctionItemUrl> <Image> <Url>http://a1017.lm.a.yimg.com/7/1017/1783/000/f03batchimg.auctions.yahoo.co.jp/users/5/2/7/1/xxxxx-thumb-1208052000152677.jpg</Url> <Width>75</Width> <Height>75</Height> </Image> <Option> <StoreIconUrl>http://image.auctions.yahoo.co.jp/images/premium.gif</StoreIconUrl> <NewIconUrl>http://image.auctions.yahoo.co.jp/i/auctions/new3.gif</NewIconUrl> <EscrowIconUrl>http://image.auctions.yahoo.co.jp/images/uketorigo.gif</EscrowIconUrl> <FeaturedIconUrl>http://image.auctions.yahoo.co.jp/images/featured.gif</FeaturedIconUrl> <CheckIconUrl>http://img.yahoo.co.jp/i/auctions/help/2-10-6.gif</CheckIconUrl> <FreeShippingIconUrl/> <WrappingIconUrl/> <BuynowIconUrl/> <EasyPaymentIconUrl/> <GiftIconUrl/> <ItemStatusNewIconUrl/> <YBankIconUrl/> <EnglishIconUrl/> <StarClubIconUrl/> <PointIconUrl/> <IsBold>true</IsBold> <IsBackGroundColor>false</IsBackGroundColor> </Option> </Result> </ResultSet>

エラー

マイ・オークション表示（出品終了分）Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

※マイ・オークション表示（出品終了分）Web APIは、24時間中1IPアドレスにつき50,000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。
※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）
※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を解除させていただきます。（無料）
まずはヘルプページのお問い合わせフォームからご相談ください。