オークション

出品リスト

リクエスト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

※PHPserialize、JSONPのリクエストURLは非推奨です。outputパラメータを利用してください。

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

リクエストパラメータ

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

パラメータ 説明
appid(必須) string アプリケーションのIDです。詳細はこちらをご覧ください。
output string XML、PHPserialize、JSONPでレスポンスの出し別けを行います。
  • xml :xmlレスポンス(デフォルト)
  • php :PHPserializeレスポンス
  • json :JSONPレスポンス
(※公開しておりましたPHPserialize、JSONP専用のエントリポイントは今後、非推奨となります。こちらのリクエスト指定をご利用ください。)
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!かんたん決済の利用が可能な商品の絞り込み指定です。指定のない場合はすべての商品になります。
new integer 「new」アイコンのついた商品の絞り込み指定です。指定のない場合はすべての商品になります。
freeshipping integer 送料無料の商品の絞り込み指定です。指定のない場合はすべての商品になります。
wrappingicon integer 贈答品向き商品の絞り込み指定です。指定のない場合はすべての商品になります。
buynow integer 即決価格が設定されている商品の絞り込み指定です。指定のない場合はすべての商品になります。
thumbnail integer 画像ありの商品の絞り込み指定です。指定のない場合はすべての商品になります。
attn integer 注目のオークションの商品の絞り込み指定です。指定のない場合はすべての商品になります。
point integer Tポイントの設定された商品の絞り込み指定です。指定のない場合はすべての商品になります。
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>


レスポンスフィールド

出品リストAPIのスキーマの記述は、以下になります。

フィールド 説明
/ResultSet クエリーレスポンスのすべてを含み、次の属性を持ちます。

  • totalResultsAvailable:該当件数の総個数です。
  • totalResultsReturned:返された値の個数です。
  • firstResultPosition:最初のデータが何個目に当たるかです。

/ResultSet/Result 各個別レスポンスを含みます。
/ResultSet/Result/Seller 出品者に関する情報です。
/ResultSet/Result/Seller/Id 出品者のYahoo! JAPAN IDです
/ResultSet/Result/Seller/ItemListUrl この出品者の出品リストを取得するリクエストURLです。
(appidは含まれていませんのでご注意ください)
/ResultSet/Result/Seller/AboutUrl この出品者の自己紹介ページのURLです。
/ResultSet/Result/Seller/RatingUrl この出品者の評価リストを取得するリクエストURLです。
(appidは含まれていませんのでご注意ください)
/ResultSet/Result/Seller/Rating 出品者の評価を表現するフィールドです。
/ResultSet/Result/Seller/Rating/Point 出品者の評価ポイントです。新規の際には0を設定します。
/ResultSet/Result/Seller/Rating/IsSuspended 停止中の際、trueとなります。
/ResultSet/Result/Seller/Rating/IsDeleted 登録削除済みの際、trueとなります。
/ResultSet/Result/Item 商品(オークション)の情報を含みます。
/ResultSet/Result/Item/AuctionID 商品(オークション)のIDです。
/ResultSet/Result/Item/Title 商品(オークション)のタイトルです。
/ResultSet/Result/Item/ItemUrl 商品詳細APIのURLです。
/ResultSet/Result/Item/AuctionItemUrl 商品(オークション)のURLです。
/ResultSet/Result/Item/Image 画像(サムネイル)のURLです。以下の属性を持ちます。
  • width:サムネイルの横幅です。
  • height:サムネイルの縦幅です。
/ResultSet/Result/Item/CurrentPrice 現在価格です。¥記号やカンマは含みません。小数点第二位までの精度です。
/ResultSet/Result/Item/Bids 現在の入札数です。
/ResultSet/Result/Item/EndTime 終了予定日時です。RFC3339に準拠した表現を用います。
(例:2004-04-01T12:00:00+09:00)
/ResultSet/Result/Item/BidOrbuy 即決価格です。(設定されていない場合は要素なし)
/ResultSet/Result/Item/IsReserved 最低落札価格の有無です。 (あり:true なし:false
/ResultSet/Result/Item/CharityOption チャリティオプションの設定です。
/ResultSet/Result/Item/CharityOption/Proportion チャリティオプション寄付率、未設定の場合は0
/ResultSet/Result/Item/Option 商品(オークション)に設定されているオプション情報です。
/ResultSet/Result/Item/Option/NewIcon 「new」アイコンのURLです。
/ResultSet/Result/Item/Option/StoreIcon 「ストア」アイコンのURLです。
/ResultSet/Result/Item/Option/PublicIcon 「官公庁オークション」アイコンのURLです。
/ResultSet/Result/Item/Option/FeaturedIcon 「注目のオークション」アイコンのURLです。
/ResultSet/Result/Item/Option/FreeshippingIcon 「送料無料」アイコンのURLです。
/ResultSet/Result/Item/Option/NewItemIcon 「新品」アイコンのURLです。
/ResultSet/Result/Item/Option/WrappingIcon 「贈答品」アイコンのURLです。
/ResultSet/Result/Item/Option/BuynowIcon 「即決価格あり」アイコンのURLです。
/ResultSet/Result/Item/Option/EasyPaymentIcon 「Yahoo!かんたん決済」アイコンのURLです。
/ResultSet/Result/Item/Option/GiftIcon 「目立ち」アイコンのURLです。
/ResultSet/Result/Item/Option/PointIcon 「Tポイント」アイコンのURLです。
/ResultSet/Result/Item/Option/CharityOptionIcon 「チャリティオプション」アイコンのURLです。(10%用と100%用あり)
/ResultSet/Result/Item/Option/IsBold 太字設定の有無です。 (あり:true なし:false
/ResultSet/Result/Item/Option/IsBackGroundColor 背景色設定の有無です。 (あり:true なし:false
/ResultSet/Result/Item/Option/IsOffer 値下げ交渉設定の有無です。 (あり:true なし:false
/ResultSet/Result/Item/Option/IsCharity チャリティオプション設定の有無です。 (あり:true なし:false



サンプルレスポンス

<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>abcdef</Id>
      <ItemListUrl>http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList?sellerID=abcdef </ItemListUrl>
      <AboutUrl>http://user.auctions.yahoo.co.jp/jp/show/aboutme?userID=abcdef </AboutUrl>
      <RatingUrl>http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?id=abcdef </RatingUrl>
      <Rating>
        <Point>520</Point>
        <IsSuspended>false</IsSuspended>
        <IsDeleted>false</IsDeleted>
      </Rating>
    </Seller>
    <Item>
      <AuctionID>a123456789</AuctionID>
      <Title>★TEIN:テイン:65φ:車高長調整リング★</Title>
      <ItemUrl>http://auctions.yahooapis.jp/AuctionWebService/V2/auctionItem?auctionID=a123456789 </ItemUrl>
      <AuctionItemUrl>http://page7.auctions.yahoo.co.jp/jp/auction/g124303953 </AuctionItemUrl>
      <Image width="205" height="100">http://auctions.c.yimg.jp/img367.auctions.yahoo.co.jp/users/2/9/2/6/abcdef-thumb-1361068291106494.jpg </Image>
      <CurrentPrice>1000.00</CurrentPrice>
      <Bids>0</Bids>
      <EndTime>2013-03-03T21:20:50+09:00</EndTime>
      <IsReserved>false</IsReserved>
      <CharityOption>
        <Proportion>0</Proportion>
      </CharityOption>
      <Option>
        <NewItemIcon>http://image.auctions.yahoo.co.jp/images/gift/c_attention_01.gif </NewItemIcon>
        <EasyPaymentIcon>http://i.yimg.jp/images/pay/icon_s16.gif</EasyPaymentIcon>
        <IsBold>false</IsBold>
        <IsBackGroundColor>false</IsBackGroundColor>
        <IsOffer>false</IsOffer>
        <IsCharity>false</IsCharity>
      </Option>
    </Item>
    <Item>
      <AuctionID>b123456789</AuctionID>
      <Title>★クローラー★Gmade★メタルパネル★即決のみ送料無料★</Title>
      <ItemUrl>http://auctions.yahooapis.jp/AuctionWebService/V2/auctionItem?auctionID=b123456789 </ItemUrl>
      <AuctionItemUrl>http://page18.auctions.yahoo.co.jp/jp/auction/w84294147 </AuctionItemUrl>
      <Image width="120" height="100">http://auctions.c.yimg.jp/img373.auctions.yahoo.co.jp/users/2/9/2/6/abcdef-thumb-1361666260164530.jpg </Image>
      <CurrentPrice>1500.00</CurrentPrice>
      <Bids>0</Bids>
      <EndTime>2013-03-03T21:21:34+09:00</EndTime>
      <BidOrBuy>3000.00</BidOrBuy>
      <IsReserved>false</IsReserved>
      <CharityOption>
        <Proportion>0</Proportion>
      </CharityOption>
      <Option>
        <BuynowIcon>http://image.auctions.yahoo.co.jp/images/buynow.gif </BuynowIcon>
        <EasyPaymentIcon>http://i.yimg.jp/images/pay/icon_s16.gif</EasyPaymentIcon>
        <IsBold>false</IsBold>
        <IsBackGroundColor>false</IsBackGroundColor>
        <IsOffer>false</IsOffer>
        <IsCharity>false</IsCharity>
      </Option>
    </Item>
  </Result>
</ResultSet>

サンプルレスポンス(PHPserialize)

a: 1: {
  s: 9: "ResultSet";
  a: 4: {
    s: 21: "totalResultsAvailable";
    s: 1: "2";
    s: 20: "totalResultsReturned";
    s: 1: "2";
    s: 19: "firstResultPosition";
    s: 1: "1";
    s: 6: "Result";
    a: 2: {
      s: 6: "Seller";
      a: 5: {
        s: 2: "Id";
        s: 6: "abcder";
        s: 11: "ItemListUrl";
        s: 77: "http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList?sellerID=abcder";
        s: 8: "AboutUrl";
        s: 62: "http://user.auctions.yahoo.co.jp/jp/show/aboutme?userID=abcder";
        s: 9: "RatingUrl";
        s: 70: "http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?id=abcder";
        s: 6: "Rating";
        a: 3: {
          s: 5: "Point";
          s: 3: "520";
          s: 11: "IsSuspended";
          b: 0;
          s: 9: "IsDeleted";
          b: 0;
        }
      }
      s: 4: "Item";
      a: 2: {
        i: 0;
        a: 13: {
          s: 9: "AuctionID";
          s: 10: "a123456789";
          s: 5: "Title";
          s: 60: "★TEIN:テイン:65φ:車高長調整リング★";
          s: 7: "ItemUrl";
          s: 82: "http://auctions.yahooapis.jp/AuctionWebService/V2/auctionItem?auctionID=a123456789";
          s: 14: "AuctionItemUrl";
          s: 55: "http://page7.auctions.yahoo.co.jp/jp/auction/a123456789";
          s: 5: "Image";
          s: 101: "http://auctions.c.yimg.jp/img367.auctions.yahoo.co.jp/users/2/9/2/6/abcder-thumb-1361068291106494.jpg";
          s: 10: "ImageWidth";
          s: 3: "205";
          s: 11: "ImageHeight";
          s: 3: "100";
          s: 12: "CurrentPrice";
          s: 7: "1000.00";
          s: 4: "Bids";
          s: 1: "0";
          s: 7: "EndTime";
          s: 25: "2013-03-03T21:20:50+09:00";
          s: 10: "IsReserved";
          b: 0;
          s: 13: "CharityOption";
          a: 1: {
            s: 10: "Proportion";
            s: 1: "0";
          }
          s: 6: "Option";
          a: 6: {
            s: 11: "NewItemIcon";
            s: 64: "http://image.auctions.yahoo.co.jp/images/gift/c_attention_01.gif";
            s: 15: "EasyPaymentIcon";
            s: 40: "http://i.yimg.jp/images/pay/icon_s16.gif";
            s: 6: "IsBold";
            b: 0;
            s: 17: "IsBackGroundColor";
            b: 0;
            s: 7: "IsOffer";
            b: 0;
            s: 9: "IsCharity";
            b: 0;
          }
        }
        i: 1;
        a: 14: {
          s: 9: "AuctionID";
          s: 9: "b123456789";
          s: 5: "Title";
          s: 87: "★クローラー★Gmade★メタルパネル★即決のみ送料無料★";
          s: 7: "ItemUrl";
          s: 81: "http://auctions.yahooapis.jp/AuctionWebService/V2/auctionItem?auctionID=b123456789";
          s: 14: "AuctionItemUrl";
          s: 55: "http://page18.auctions.yahoo.co.jp/jp/auction/b123456789";
          s: 5: "Image";
          s: 101: "http://auctions.c.yimg.jp/img373.auctions.yahoo.co.jp/users/2/9/2/6/abcder-thumb-1361666260164530.jpg";
          s: 10: "ImageWidth";
          s: 3: "120";
          s: 11: "ImageHeight";
          s: 3: "100";
          s: 12: "CurrentPrice";
          s: 7: "1500.00";
          s: 4: "Bids";
          s: 1: "0";
          s: 7: "EndTime";
          s: 25: "2013-03-03T21:21:34+09:00";
          s: 8: "BidOrBuy";
          s: 7: "3000.00";
          s: 10: "IsReserved";
          b: 0;
          s: 13: "CharityOption";
          a: 1: {
            s: 10: "Proportion";
            s: 1: "0";
          }
          s: 6: "Option";
          a: 6: {
            s: 10: "BuynowIcon";
            s: 51: "http://image.auctions.yahoo.co.jp/images/buynow.gif";
            s: 15: "EasyPaymentIcon";
            s: 40: "http://i.yimg.jp/images/pay/icon_s16.gif";
            s: 6: "IsBold";
            b: 0;
            s: 17: "IsBackGroundColor";
            b: 0;
            s: 7: "IsOffer";
            b: 0;
            s: 9: "IsCharity";
            b: 0;
          }
        }
      }
    }
  }
}

サンプルレスポンス(JSONP)

loaded({
  ResultSet: {@attributes: {
      totalResultsAvailable: "2",
      totalResultsReturned: "2",
      firstResultPosition: "1"
    },
    Result: {
      Seller: {
        Id: "abcdef",
        ItemListUrl: "http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList?sellerID=abcdef",
        AboutUrl: "http://user.auctions.yahoo.co.jp/jp/show/aboutme?userID=abcdef",
        RatingUrl: "http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?id=abcdef",
        Rating: {
          Point: "520",
          IsSuspended: "false",
          IsDeleted: "false"
        }
      },
      Item: [{
        AuctionID: "a123456789",
        Title: "★TEIN:テイン:65φ:車高長調整リング★",
        ItemUrl: "http://auctions.yahooapis.jp/AuctionWebService/V2/auctionItem?auctionID=a123456789",
        AuctionItemUrl: "http://page7.auctions.yahoo.co.jp/jp/auction/g124303953",
        Image: "http://auctions.c.yimg.jp/img367.auctions.yahoo.co.jp/users/2/9/2/6/abcdef-thumb-1361068291106494.jpg",
        CurrentPrice: "1000.00",
        Bids: "0",
        EndTime: "2013-03-03T21:20:50+09:00",
        IsReserved: "false",
        CharityOption: {
          Proportion: "0"
        },
        Option: {
          NewItemIcon: "http://image.auctions.yahoo.co.jp/images/gift/c_attention_01.gif",
          EasyPaymentIcon: "http://i.yimg.jp/images/pay/icon_s16.gif",
          IsBold: "false",
          IsBackGroundColor: "false",
          IsOffer: "false",
          IsCharity: "false"
        }
      }, {
        AuctionID: "b123456789",
        Title: "★クローラー★hogehoge★メタルパネル★即決のみ送料無料★",
        ItemUrl: "http://auctions.yahooapis.jp/AuctionWebService/V2/auctionItem?auctionID=b123456789",
        AuctionItemUrl: "http://page18.auctions.yahoo.co.jp/jp/auction/w84294147",
        Image: "http://auctions.c.yimg.jp/img373.auctions.yahoo.co.jp/users/2/9/2/6/abcdef-thumb-1361666260164530.jpg",
        CurrentPrice: "1500.00",
        Bids: "0",
        EndTime: "2013-03-03T21:21:34+09:00",
        BidOrBuy: "3000.00",
        IsReserved: "false",
        CharityOption: {
          Proportion: "0"
        },
        Option: {
          BuynowIcon: "http://image.auctions.yahoo.co.jp/images/buynow.gif",
          EasyPaymentIcon: "http://i.yimg.jp/images/pay/icon_s16.gif",
          IsBold: "false",
          IsBackGroundColor: "false",
          IsOffer: "false",
          IsCharity: "false"
        }
      }]
    }
  }
})



エラー

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