オークション

出品リスト

Version 1 ｜ Version 2

リクエストURL

XML

http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList

PHPserialize

http://auctions.yahooapis.jp/AuctionWebService/V2/php/sellingList

JSONP

http://auctions.yahooapis.jp/AuctionWebService/V2/json/sellingList

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

リクエストパラメータ

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

パラメータ	値	説明
appid（必須）	string	アプリケーションのIDです。詳細はこちらをご覧ください。
callback	string	JSONPとして出力する際のコールバック関数名を入力するためのパラメータです。UTF-8でエンコードした文字列を入力します。
sellerID(必須）	string	出品者のYahoo! JAPAN IDです。
page	integer	出品リストのページ番号です。指定のない場合は1ページ目のリクエストとみなします。
sort	string	ソート項目です。指定のない場合は終了日時の昇順（近い順）になります。 end ：終了日時 img ：画像の有無 bids ：入札件数 cbids ：現在価格 bidorbuy ：即決価格
order	string	ソートの順番です。（a ：昇順　d ：降順）
store	integer	商品の出品区分の絞り込み指定です。 0 ：すべての商品 1 ：オークションストアの出品 2 ：一般の出品者の出品
aucminprice	integer	商品価格の範囲指定の下限値です。指定のない場合は下限値指定なしとみなします。
aucmaxprice	integer	商品価格の範囲指定の上限値です。指定のない場合は上限値指定なしとみなします。
aucmin_bidorbuy_price	integer	即決価格の範囲指定の下限値です。指定のない場合は下限値指定なしとみなします。
aucmax_bidorbuy_price	integer	即決価格の範囲指定の上限値です。指定のない場合は上限値指定なしとみなします。
easypayment	integer	Yahoo!かんたん決済の利用が可能な商品の絞り込み指定です。指定のない場合はすべての商品になります。
ybank	integer	Yahoo!ネットバンキングの利用が可能な商品の絞り込み指定です。指定のない場合はすべての商品になります。
new	integer	「new」アイコンのついた商品の絞り込み指定です。指定のない場合はすべての商品になります。
freeshipping	integer	送料無料の商品の絞り込み指定です。指定のない場合はすべての商品になります。
wrappingicon	integer	贈答品向き商品の絞り込み指定です。指定のない場合はすべての商品になります。
buynow	integer	即決価格が設定されている商品の絞り込み指定です。指定のない場合はすべての商品になります。
thumbnail	integer	画像ありの商品の絞り込み指定です。指定のない場合はすべての商品になります。
attn	integer	注目のオークションの商品の絞り込み指定です。指定のない場合はすべての商品になります。
english	integer	Yahoo!オークション英語版の絞り込み指定です。指定のない場合はすべての商品になります。
point	integer	Yahoo!ポイントの設定された商品の絞り込み指定です。指定のない場合はすべての商品になります。
gift_icon	integer	目立ちアイコンのついた商品の絞り込み指定です。 0 ：指定なし 2 ：美品 3 ：非売品 4 ：限定品 5 ：保証書付 6 ：全巻セット 7 ：正規店購入 8 ：産地直送指定のない場合はすべての商品になります。
item_status	integer	商品状態での絞り込み指定です。 0 ：指定なし 1 ：新品 2 ：中古指定のない場合はすべての商品になります。
offer	integer	値下げ交渉が設定された商品の絞り込み指定です。指定のない場合はすべての商品になります。

サンプルリクエストURL

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

レスポンスフィールド

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

フィールド	説明
ResultSet	クエリーレスポンスのすべてを含み、次の属性を持ちます。 totalResultsAvailable：該当件数の総個数です。 totalResultsReturned：返された値の個数です。 firstResultPosition：最初のデータが何個目に当たるかです。
Result	各個別レスポンスを含みます。
Seller	出品者に関する情報です。
Id	出品者のYahoo! JAPAN IDです
ItemListUrl	この出品者の出品リストを取得するリクエストURLです。（appidは含まれていませんのでご注意ください）
AboutUrl	この出品者の自己紹介ページのURLです。
RatingUrl	この出品者の評価リストを取得するリクエストURLです。（appidは含まれていませんのでご注意ください）
Rating	出品者の評価を表現するフィールドです。
Point	出品者の評価ポイントです。新規の際には0を設定します。
IsSuspended	停止中の際、`true`となります。
IsDeleted	登録削除済みの際、`true`となります。
Item	商品（オークション）の情報を含みます。
AuctionID	商品（オークション）のIDです。
Title	商品（オークション）のタイトルです。
ItemUrl	商品（オークション）のURLです。
Image	画像（サムネイル）のURLです。以下の属性を持ちます。 width：サムネイルの横幅です。 height：サムネイルの縦幅です。
CurrentPrice	CurrentPrice 現在価格です。¥記号やカンマは含みません。小数点第二位までの精度です。
Bids	現在の入札数です。
EndTime	終了予定日時です。RFC3339に準拠した表現を用います。（例：2004-04-01T12:00:00+09:00）
BidOrbuy	即決価格です。（設定されていない場合は要素なし）
IsReserved	最低落札価格の有無です。（あり：`true`　なし：`false`）
Option	商品（オークション）に設定されているオプション情報です。
NewIcon	「new」アイコンのURLです。
StoreIcon	「ストア」アイコンのURLです。
CheckIcon	「鑑定済み」アイコンのURLです。
PublicIcon	「官公庁オークション」アイコンのURLです。
FeaturedIcon	「注目のオークション」アイコンのURLです。
FreeshippingIcon	「送料無料」アイコンのURLです。
NewItemIcon	「新品」アイコンのURLです。
YBankIcon	Yahoo!ネットバンキング対応の場合に「Yahoo!ネットバンキング」アイコンのURLが設定されます。
WrappingIcon	「贈答品」アイコンのURLです。
BuynowIcon	「即決価格」アイコンのURLです。
EasyPaymentIcon	「Yahoo!かんたん決済」アイコンのURLです。
GiftIcon	「目立ち」アイコンのURLです。
EnglishIcon	「Yahoo!オークション英語版」アイコンのURLです。
PointIcon	「Yahoo!ポイント」アイコンのURLです。
IsBold	太字設定の有無です。（あり：`true`　なし：`false`）
IsBackGroundColor	背景色設定の有無です。（あり：`true`　なし：`false`）
IsOffer	値下げ交渉設定の有無です。（あり：`true`　なし：`false`）

サンプルレスポンス

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

<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet 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/V2/sellingList.xsd" totalResultsAvailable="2" totalResultsReturned="2" firstResultPosition="1">
 <Result>
  <Seller>
   <Id>hogehoge</Id>
   <ItemListUrl>http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList?appid=sampl_appid&sellerID=hogehoge</ItemListUrl>
   <AboutUrl>http://user.auctions.yahoo.co.jp/jp/show/aboutme?userID=hogehoge</AboutUrl>
   <RatingUrl>http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?appid=sampl_appid&id=hogehoge</RatingUrl>
   <Rating>
    <Point>0</Point>
    <IsSuspended>false</IsSuspended>
    <IsDeleted>false</IsDeleted>
   </Rating>
  </Seller>
  <Item>
   <AuctionID>x12345</AuctionID>
   <Title>サンプルタイトル１</Title>
   <ItemUrl>http://auctions.yahooapis.jp/AuctionWebService/V2/auctionItem?appid=sampl_appid&auctionID=x12345</ItemUrl>
   <Image width="134" height="100">http://i.yimg.jp/images/auct/template/ui/search/na_134x100.gif</Image>
   <CurrentPrice>100.00</CurrentPrice>
   <Bids>1</Bids>
   <EndTime>2009-03-09T14:18:27+09:00</EndTime>
   <IsReserved>false</IsReserved>
   <Option>
    <FeaturedIcon>http://image.auctions.yahoo.co.jp/images/featured.gif</FeaturedIcon>
    <EasyPaymentIcon>http://i.yimg.jp/images/pay/icon_s16.gif</EasyPaymentIcon>
    <IsBold>false</IsBold>
    <IsBackGroundColor>false</IsBackGroundColor>
   </Option>
  </Item>
  <Item>
   <AuctionID>x67890</AuctionID>
   <Title>サンプルタイトル２</Title>
   <ItemUrl>http://auctions.yahooapis.jp/AuctionWebService/V2/auctionItem?appid=sampl_appid&auctionID=x67890</ItemUrl>
   <Image width="134" height="100">http://i.yimg.jp/images/auct/template/ui/search/na_134x100.gif</Image>
   <CurrentPrice>100.00</CurrentPrice>
   <Bids>0</Bids>
   <EndTime>2009-03-09T16:10:59+09:00</EndTime>
   <IsReserved>false</IsReserved>
   <Option>
    <EasyPaymentIcon>http://i.yimg.jp/images/pay/icon_s16.gif</EasyPaymentIcon>
    <IsBold>false</IsBold>
    <IsBackGroundColor>false</IsBackGroundColor>
   </Option>
  </Item>
 </Result>
</ResultSet>

サンプルレスポンス（PHPserialize）

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

array (
  'ResultSet' => 
  array (
    'totalResultsAvailable' => '2',
    'totalResultsReturned' => '2',
    'firstResultPosition' => '1',
    'Result' => 
    array (
      'Seller' => 
      array (
        'Id' => 'hogehoge',
        'ItemListUrl' => 'http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList?sellerID=hogehoge',
        'AboutUrl' => 'http://testdev014.auc.bbt.yahoo.co.jp:9111/jp/show/aboutme?userID=hogehoge',
        'RatingUrl' => 'http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?id=hogehoge',
        'Rating' => 
        array (
          'Point' => '0',
          'IsSuspended' => false,
          'IsDeleted' => false,
        ),
      ),
      'Item' => 
      array (
        0 => 
        array (
          'AuctionID' => 'x12345',
          'Title' => 'サンプルタイトル１',
          'ItemUrl' => 'http://auctions.yahooapis.jp/AuctionWebService/V2/auctionItem?appid=&auctionID=x12345',
          'Image' => 'http://i.yimg.jp/images/auct/template/ui/search/na_134x100.gif',
          'CurrentPrice' => '100.00',
          'Bids' => '1',
          'EndTime' => '2009-03-09T14:18:27+09:00',
          'IsReserved' => false,
          'Option' => 
          array (
            'FeaturedIcon' => 'http://image.auctions.yahoo.co.jp/images/featured.gif',
            'EasyPaymentIcon' => 'http://i.yimg.jp/images/pay/icon_s16.gif',
            'IsBold' => false,
            'IsBackGroundColor' => false,
          ),
        ),
        1 => 
        array (
          'AuctionID' => 'x67890',
          'Title' => 'サンプルタイトル２',
          'ItemUrl' => 'http://auctions.yahooapis.jp/AuctionWebService/V2/auctionItem?auctionID=x67890',
          'Image' => 'http://i.yimg.jp/images/auct/template/ui/search/na_134x100.gif',
          'CurrentPrice' => '100.00',
          'Bids' => '0',
          'EndTime' => '2009-03-09T16:10:59+09:00',
          'IsReserved' => false,
          'Option' => 
          array (
            'EasyPaymentIcon' => 'http://i.yimg.jp/images/pay/icon_s16.gif',
            'IsBold' => false,
            'IsBackGroundColor' => false,
          ),
        ),
      ),
    ),
  ),
)

サンプルレスポンス（JSONP）

以下は、sellerID=hogehoge, callback=loaded のクエリーの結果です。

loaded(
{
    "AuctionSellingList":
    {
        "@attributes":
        {
            "totalAuctions":"1498",
            "totalPage":"30",
            "curPage":"1"
        },
        "seller":
        {
            "id":"hogehoge",
            "itemlist":"http:\/\/api.auctions.yahoo.co.jp\/AuctionWebService\/V2\/SellingList?sellerID=hogehoge",
            "about":"http:\/\/user.auctions.yahoo.co.jp\/jp\/show\/aboutme?userID=hogehoge",
            "rating":"http:\/\/rating5.auctions.yahoo.co.jp\/jp\/show\/rating?userID=hogehoge"
        },
        "item":[
        {
            "auctionID":"x12345",
            "title":"\u65e5\u672c\u3067\u958b\u767a\u30fb\u8a71\u984c\u65b0\u5546\u54c1\u30de\u30a6\u30b9\u3068\u30b8\u30e7\u30a4\u30b9\u30c6\u30a3\u30c3\u30af\u6a5f\u80fd\u6301\u3064OZUPAD",
            "url":"http:\/\/page21.auctions.yahoo.co.jp\/jp\/auction\/x12345",
            "img":"http:\/\/auctions.yahooapis.jp\/AuctionWebService\/V2\/auctionItem?appid=sampl_appid&auctionID=x12345",
            "price":"2,    980 \u5186",
            "bids":"0",
            "endtime":"3\u6708 24\u65e5 21\u6642 11\u5206",
            "bidorbuy":"2,980 \u5186",
            "option":
            {
                "store":"http:\/\/image.auctions.yahoo.co.jp\/images\/premium.gif",
                "buynow":"http:\/\/image.auctions.yahoo.co.jp\/images\/buynow.gif",
                "easypayment":"http:\/\/i.yimg.jp\/images\/pay\/icon_s16.gif"
            }
        },
        {
            "auctionID":"x67890",
            "title":"NEC FOMA N2102V\u643a\u5e2f\u96fb\u8a71\u2605\u7d76\u5bfe\u304a\u8cb7\u3044\u5f97\u306a\u5546\u54c1",
            "url":"http:\/\/page21.auctions.yahoo.co.jp\/jp\/auction\/j28491084",
            "img":"http:\/\/i.yimg.jp\/images\/auct\/template\/ui\/search\/na_134x100.gif",
            "price":"2,580 \u5186",
            "bids":"0",
            "endtime":"3\u6708 24\u65e5 21\u6642 11\u5206",
            "bidorbuy":"2,980 \u5186",
            "option":
            {
                "store":"http:\/\/image.auctions.yahoo.co.jp\/images\/premium.gif",
                "buynow":"http:\/\/image.auctions.yahoo.co.jp\/images\/buynow.gif",
                "easypayment":"http:\/\/i.yimg.jp\/images\/pay\/icon_s16.gif"
            }
        }]
    }
})

エラー

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

出品リスト

リクエストURL

リクエストパラメータ

レスポンスフィールド

サンプルレスポンス

サンプルレスポンス（PHPserialize）

サンプルレスポンス（JSONP）

エラー

出品リストを使用した開発に関するQ＆A

お役立ち度の高い解決済みの質問

Web APIとその他のサービス

API

その他

このAPIを使ったサンプルコード

関連ドキュメント

開発者ブログ

開発者コミュニティ

開発のヒント

法人デベロッパー専用お問い合わせ