デベロッパーネットワークトップ > オークション > マイ・オークション表示（ウォッチリスト・開催中のオークション）
オークション

マイ・オークション表示（ウォッチリスト・開催中のオークション）

リクエストURL
XML
https://auctions.yahooapis.jp/AuctionWebService/V2/openWatchList

※2012/11/7以前に取得されたOAuth1.0のConsumer Keyをご利用頂く場合のリクエストURLは
https://auctions.yahooapis.jp/AuctionWebService/V2/openWatchList となります

ログインしているYahoo! JAPAN IDのマイ・オークションの「ウォッチリスト・開催中のオークション」を参照します。

リクエストパラメータ

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

パラメータ 値 説明
output string XML、PHPserialize、JSONPでレスポンスの出し別けを行います。
  • xml ：xmlレスポンス(デフォルト)
  • php ：PHPserializeレスポンス
  • json ：JSONPレスポンス
callback string JSONPとして出力する際のコールバック関数名を入力するためのパラメータです。UTF-8でエンコードした文字列を入力します。
start integer 検索するページ番号を指定します。
result integer 結果の件数を指定するためのパラメータです。デフォルトは50、最大100まで指定可能です。

※こちらのAPIはYahoo! ID連携に対応したAPIです。
Yahoo! ID連携によるAPIアクセス方法の詳細は、以下のページをご確認ください。
・Yahoo! ID連携
・Yahoo! ID連携によるAPIアクセス実装方法

※アプリケーションIDを取得する際に「マイ・オークション関連の機能」スコープを選択してください。
スコープの詳細は、「スコープに関して」でご確認ください。


サンプルリクエストURL

https://auctions.yahooapis.jp/AuctionWebService/V2/openWatchList?start=<参照するページ番号>

サンプルリクエスト

GET /AuctionWebService/V2/openWatchList?start=<参照するページ番号> HTTP/1.1
Host: auctions.yahooapis.jp
Authorization: Bearer <アクセストークン> 

レスポンスフィールド

マイ・オークション表示（ウォッチリスト・開催中のオークション）APIのスキーマの記述は以下になります。

フィールド 説明
/ResultSet クエリーレスポンスのすべてを含み、次の属性を持ちます。
  • totalResultsAvailable：該当件数の総個数です。
  • totalResultsReturned：返された値の個数です。
  • firstResultPosition：最初のデータが何個目に当たるかです。
/ResultSet/Result 各個別レスポンスを含みます。
/ResultSet/Result/AuctionID オークションIDです。
/ResultSet/Result/Title 商品のタイトルです。
/ResultSet/Result/CurrentPrice 現在価格です。¥記号やカンマは含みません。小数点第二位までの精度です。
/ResultSet/Result/Bids 現在の入札数です。
/ResultSet/Result/YPoint Tポイントのレートです。小数点第一までの精度です。
/ResultSet/Result/Seller/Id 出品者のYahoo! JAPAN IDです。
/ResultSet/Result/Seller/ItemListUrl 出品者の出品リストを取得するリクエストURLです。（appidは含まれていませんのでご注意ください）。
/ResultSet/Result/CurrentWinner/Id 最高額入札者のYahoo! JAPAN IDです。
ItemListUrl /ResultSet/Result/CurrentWinner/ItemListUrl 最高額入札者の出品リストを取得するリクエストURLです。（appidは含まれていませんのでご注意ください）。
/ResultSet/Result/EndTime 終了予定日時です。RFC3339に準拠した表現を用います。（例：2004-04-01T12:00:00+09:00）
/ResultSet/Result/AuctionItemUrl 商品詳細のURLです。
/ResultSet/Result/Image 画像（サムネイル） の情報です。
/ResultSet/Result/Image/Url 画像（サムネイル）のURLです。
/ResultSet/Result/Image/Width 画像（サムネイル）の幅です。
/ResultSet/Result/Image/Height 画像（サムネイル）の高さです。
/ResultSet/Result/IsReminder リマンダー設定。（あり：true　なし：false）
/ResultSet/Result/CharityOption チャリティオプション情報です。
/ResultSet/Result/CharityOption/Proportion チャリティオプション寄付率、未設定の場合は0
/ResultSet/Result/Option 各オプションの設定状況です。
/ResultSet/Result/Option/StoreIconUrl ストア商品の場合ストアアイコンのURLが設定されます。
/ResultSet/Result/Option/NewIconUrl 出品されてから間もない商品に付く「New」アイコンのURLです。
/ResultSet/Result/Option/FeaturedIconUrl 注目のオークション設定アイコンのURLです。
/ResultSet/Result/Option/FreeShippingIconUrl 「送料無料」のアイコンのURLです。
/ResultSet/Result/Option/WrappingIconUrl 「贈答品」アイコンのURLです。
/ResultSet/Result/Option/BuynowIconUrl 「即決価格あり」アイコンのURLです。
/ResultSet/Result/Option/EasyPaymentIconUrl 「Yahoo!かんたん決済」アイコンのURLです。
/ResultSet/Result/Option/GiftIconUrl 「目立ち」アイコンのURLです。
/ResultSet/Result/Option/ItemStatusNewIconUrl 「新品」アイコンのURLです。設定されていない場合は空。
/ResultSet/Result/Option/PointIconUrl 「Tポイント」アイコンのURLです。設定されていない場合は空。
/ResultSet/Result/Option/CharityOptionIconUrl 「チャリティオプション」アイコンのURLです。（10%用と100%用あり）
/ResultSet/Result/Option/IsBold 太字の設定です。（あり：true　なし：false）
/ResultSet/Result/Option/IsBackGroundColor 背景色の設定です。（あり：true　なし：false）
/ResultSet/Result/Option/IsCharity チャリティオプション設定についてです。（あり：true　なし：false）


サンプルレスポンス

<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:jp:auc:openWatchList" xsi:schemaLocation="urn:yahoo:jp:auc:openWatchList http://auctions.yahooapis.jp/AuctionWebService/V2/openWatchList.xsd" totalResultsAvailable="2" totalResultsReturned="2" firstResultPosition="1">
  <Result>
    <AuctionID>y125787</AuctionID>
    <Title>テスト商品です。入札はお控えください5</Title>
    <CurrentPrice>200.00</CurrentPrice>
    <Bids>0</Bids>
    <YPoint>0.0</YPoint>
    <Seller>
      <Id>HOGEHOGE</Id>
      <ItemListUrl>http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList?sellerID=HOGEHOGE</ItemListUrl>
    </Seller>
    <CurrentWinner>
      <Id></Id>
      <ItemListUrl></ItemListUrl>
    </CurrentWinner>
    <EndTime>2013-02-21T17:52:41+09:00</EndTime>
    <AuctionItemUrl>http://pageX.auctions.yahoo.co.jp/jp/auction/x125787</AuctionItemUrl>
    <Image>
      <Url>http://image.auctions.yahoo.co.jp/images/na_75x75.gif</Url>
      <Width>75</Width>
      <Height>75</Height>
    </Image>
    <IsReminder>true</IsReminder>
    <CharityOption>
      <Proportion>0</Proportion>
    </CharityOption>
    <Option>
      <StoreIconUrl></StoreIconUrl>
      <CheckIconUrl></CheckIconUrl>
      <NewIconUrl>http://image.auctions.yahoo.co.jp/i/auctions/new3.gif</NewIconUrl>
      <EscrowIconUrl></EscrowIconUrl>
      <FeaturedIconUrl></FeaturedIconUrl>
      <FreeShippingIconUrl></FreeShippingIconUrl>
      <WrappingIconUrl></WrappingIconUrl>
      <BuynowIconUrl>http://image.auctions.yahoo.co.jp/images/buynow.gif</BuynowIconUrl>
      <EasyPaymentIconUrl></EasyPaymentIconUrl>
      <GiftIconUrl></GiftIconUrl>
      <ItemStatusNewIconUrl></ItemStatusNewIconUrl>
      <YBankIconUrl></YBankIconUrl>
      <EnglishIconUrl></EnglishIconUrl>
      <StarClubIconUrl></StarClubIconUrl>
      <CharityOptionIconUrl></CharityOptionIconUrl>
      <PointIconUrl></PointIconUrl>
      <IsBold>false</IsBold>
      <IsBackGroundColor>false</IsBackGroundColor>
      <IsCharity>false</IsCharity>
    </Option>
  </Result>
  <Result>
    <AuctionID>y125465</AuctionID>
    <Title>テスト商品です。入札はお控えください。1</Title>
    <CurrentPrice>100.00</CurrentPrice>
    <Bids>0</Bids>
    <YPoint>0.0</YPoint>
    <Seller>
      <Id>HOGEHOGE</Id>
      <ItemListUrl>http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList?sellerID=HOGEHOGE</ItemListUrl>
    </Seller>
    <CurrentWinner>
      <Id></Id>
      <ItemListUrl></ItemListUrl>
    </CurrentWinner>
    <EndTime>2013-02-22T17:52:06+09:00</EndTime>
    <AuctionItemUrl>http://pageX.auctions.yahoo.co.jp/jp/auction/x125465</AuctionItemUrl>
    <Image>
      <Url>http://image.auctions.yahoo.co.jp/images/na_75x75.gif</Url>
      <Width>75</Width>
      <Height>75</Height>
    </Image>
    <IsReminder>true</IsReminder>
    <CharityOption>
      <Proportion>0</Proportion>
    </CharityOption>
    <Option>
      <StoreIconUrl></StoreIconUrl>
      <CheckIconUrl></CheckIconUrl>
      <NewIconUrl>http://image.auctions.yahoo.co.jp/i/auctions/new3.gif</NewIconUrl>
      <EscrowIconUrl></EscrowIconUrl>
      <FeaturedIconUrl></FeaturedIconUrl>
      <FreeShippingIconUrl></FreeShippingIconUrl>
      <WrappingIconUrl></WrappingIconUrl>
      <BuynowIconUrl></BuynowIconUrl>
      <EasyPaymentIconUrl></EasyPaymentIconUrl>
      <GiftIconUrl></GiftIconUrl>
      <ItemStatusNewIconUrl></ItemStatusNewIconUrl>
      <YBankIconUrl></YBankIconUrl>
      <EnglishIconUrl></EnglishIconUrl>
      <StarClubIconUrl></StarClubIconUrl>
      <CharityOptionIconUrl></CharityOptionIconUrl>
      <PointIconUrl></PointIconUrl>
      <IsBold>false</IsBold>
      <IsBackGroundColor>false</IsBackGroundColor>
      <IsCharity>false</IsCharity>
    </Option>
  </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: {
      i: 0;
      a: 13: {
        s: 9: "AuctionID";
        s: 7: "y125787";
        s: 5: "Title";
        s: 55: "テスト商品です。入札はお控えください5";
        s: 12: "CurrentPrice";
        s: 6: "200.00";
        s: 4: "Bids";
        s: 1: "0";
        s: 6: "YPoint";
        s: 3: "0.0";
        s: 6: "Seller";
        a: 2: {
          s: 2: "Id";
          s: 17: "HOGEHOGE";
          s: 11: "ItemListUrl";
          s: 88: "http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList?sellerID=HOGEHOGE";
        }
        s: 13: "CurrentWinner";
        a: 2: {
          s: 2: "Id";
          s: 0: "";
          s: 11: "ItemListUrl";
          s: 0: "";
        }
        s: 7: "EndTime";
        s: 25: "2013-02-21T17:52:41+09:00";
        s: 14: "AuctionItemUrl";
        s: 53: "http://pageX.auctions.yahoo.co.jp/jp/auction/x125787";
        s: 5: "Image";
        a: 3: {
          s: 3: "Url";
          s: 53: "http://image.auctions.yahoo.co.jp/images/na_75x75.gif";
          s: 5: "Width";
          s: 2: "75";
          s: 6: "Height";
          s: 2: "75";
        }
        s: 10: "IsReminder";
        b: 1;
        s: 13: "CharityOption";
        a: 1: {
          s: 10: "Proportion";
          s: 1: "0";
        }
        s: 6: "Option";
        a: 19: {
          s: 12: "StoreIconUrl";
          s: 0: "";
          s: 12: "CheckIconUrl";
          s: 0: "";
          s: 10: "NewIconUrl";
          s: 53: "http://image.auctions.yahoo.co.jp/i/auctions/new3.gif";
          s: 13: "EscrowIconUrl";
          s: 0: "";
          s: 15: "FeaturedIconUrl";
          s: 0: "";
          s: 19: "FreeShippingIconUrl";
          s: 0: "";
          s: 15: "WrappingIconUrl";
          s: 0: "";
          s: 13: "BuynowIconUrl";
          s: 51: "http://image.auctions.yahoo.co.jp/images/buynow.gif";
          s: 18: "EasyPaymentIconUrl";
          s: 0: "";
          s: 11: "GiftIconUrl";
          s: 0: "";
          s: 20: "ItemStatusNewIconUrl";
          s: 0: "";
          s: 12: "YBankIconUrl";
          s: 0: "";
          s: 14: "EnglishIconUrl";
          s: 0: "";
          s: 15: "StarClubIconUrl";
          s: 0: "";
          s: 20: "CharityOptionIconUrl";
          s: 0: "";
          s: 12: "PointIconUrl";
          s: 0: "";
          s: 6: "IsBold";
          b: 0;
          s: 17: "IsBackGroundColor";
          b: 0;
          s: 9: "IsCharity";
          b: 0;
        }
      }
      i: 1;
      a: 13: {
        s: 9: "AuctionID";
        s: 7: "y125465";
        s: 5: "Title";
        s: 58: "テスト商品です。入札はお控えください。1";
        s: 12: "CurrentPrice";
        s: 6: "100.00";
        s: 4: "Bids";
        s: 1: "0";
        s: 6: "YPoint";
        s: 3: "0.0";
        s: 6: "Seller";
        a: 2: {
          s: 2: "Id";
          s: 17: "HOGEHOGE";
          s: 11: "ItemListUrl";
          s: 88: "http://auctions.yahooapis.jp/AuctionWebService/V2/sellingList?sellerID=HOGEHOGE";
        }
        s: 13: "CurrentWinner";
        a: 2: {
          s: 2: "Id";
          s: 0: "";
          s: 11: "ItemListUrl";
          s: 0: "";
        }
        s: 7: "EndTime";
        s: 25: "2013-02-22T17:52:06+09:00";
        s: 14: "AuctionItemUrl";
        s: 53: "http://pageX.auctions.yahoo.co.jp/jp/auction/x125465";
        s: 5: "Image";
        a: 3: {
          s: 3: "Url";
          s: 53: "http://image.auctions.yahoo.co.jp/images/na_75x75.gif";
          s: 5: "Width";
          s: 2: "75";
          s: 6: "Height";
          s: 2: "75";
        }
        s: 10: "IsReminder";
        b: 1;
        s: 13: "CharityOption";
        a: 1: {
          s: 10: "Proportion";
          s: 1: "0";
        }
        s: 6: "Option";
        a: 19: {
          s: 12: "StoreIconUrl";
          s: 0: "";
          s: 12: "CheckIconUrl";
          s: 0: "";
          s: 10: "NewIconUrl";
          s: 53: "http://image.auctions.yahoo.co.jp/i/auctions/new3.gif";
          s: 13: "EscrowIconUrl";
          s: 0: "";
          s: 15: "FeaturedIconUrl";
          s: 0: "";
          s: 19: "FreeShippingIconUrl";
          s: 0: "";
          s: 15: "WrappingIconUrl";
          s: 0: "";
          s: 13: "BuynowIconUrl";
          s: 0: "";
          s: 18: "EasyPaymentIconUrl";
          s: 0: "";
          s: 11: "GiftIconUrl";
          s: 0: "";
          s: 20: "ItemStatusNewIconUrl";
          s: 0: "";
          s: 12: "YBankIconUrl";
          s: 0: "";
          s: 14: "EnglishIconUrl";
          s: 0: "";
          s: 15: "StarClubIconUrl";
          s: 0: "";
          s: 20: "CharityOptionIconUrl";
          s: 0: "";
          s: 12: "PointIconUrl";
          s: 0: "";
          s: 6: "IsBold";
          b: 0;
          s: 17: "IsBackGroundColor";
          b: 0;
          s: 9: "IsCharity";
          b: 0;
        }
      }
    }
  }
}

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

loaded({
  "ResultSet": {
    "@attributes": {
      "totalResultsAvailable": "2",
      "totalResultsReturned": "2",
      "firstResultPosition": "1"
    },
    "Result": [{
      "AuctionID": "y125787",
      "Title": "\u30c6\u30b9\u30c8\u5546\u54c1\u3067\u3059\u3002\u5165\u672d\u306f\u304a\u63a7\u3048\u304f\u3060\u3055\u30445",
      "CurrentPrice": "200.00",
      "Bids": "0",
      "YPoint": "0.0",
      "Seller": {
        "Id": "HOGEHOGE",
        "ItemListUrl": "http:\/\/auctions.yahooapis.jp\/AuctionWebService\/V2\/sellingList?sellerID=HOGEHOGE"
      },
      "CurrentWinner": {
        "Id": {},
        "ItemListUrl": {}
      },
      "EndTime": "2013-02-21T17:52:41+09:00",
      "AuctionItemUrl": "http:\/\/pageX.auctions.yahoo.co.jp\/jp\/auction\/x125787",
      "Image": {
        "Url": "http:\/\/image.auctions.yahoo.co.jp\/images\/na_75x75.gif",
        "Width": "75",
        "Height": "75"
      },
      "IsReminder": "true",
      "CharityOption": {
        "Proportion": "0"
      },
      "Option": {
        "StoreIconUrl": {},
        "CheckIconUrl": {},
        "NewIconUrl": "http:\/\/image.auctions.yahoo.co.jp\/i\/auctions\/new3.gif",
        "EscrowIconUrl": {},
        "FeaturedIconUrl": {},
        "FreeShippingIconUrl": {},
        "WrappingIconUrl": {},
        "BuynowIconUrl": "http:\/\/image.auctions.yahoo.co.jp\/images\/buynow.gif",
        "EasyPaymentIconUrl": {},
        "GiftIconUrl": {},
        "ItemStatusNewIconUrl": {},
        "YBankIconUrl": {},
        "EnglishIconUrl": {},
        "StarClubIconUrl": {},
        "CharityOptionIconUrl": {},
        "PointIconUrl": {},
        "IsBold": "false",
        "IsBackGroundColor": "false",
        "IsCharity": "false"
      }
    }, {
      "AuctionID": "y125465",
      "Title": "\u30c6\u30b9\u30c8\u5546\u54c1\u3067\u3059\u3002\u5165\u672d\u306f\u304a\u63a7\u3048\u304f\u3060\u3055\u3044\u30021",
      "CurrentPrice": "100.00",
      "Bids": "0",
      "YPoint": "0.0",
      "Seller": {
        "Id": "HOGEHOGE",
        "ItemListUrl": "http:\/\/auctions.yahooapis.jp\/AuctionWebService\/V2\/sellingList?sellerID=HOGEHOGE"
      },
      "CurrentWinner": {
        "Id": {},
        "ItemListUrl": {}
      },
      "EndTime": "2013-02-22T17:52:06+09:00",
      "AuctionItemUrl": "http:\/\/pageX.auctions.yahoo.co.jp\/jp\/auction\/x125465",
      "Image": {
        "Url": "http:\/\/image.auctions.yahoo.co.jp\/images\/na_75x75.gif",
        "Width": "75",
        "Height": "75"
      },
      "IsReminder": "true",
      "CharityOption": {
        "Proportion": "0"
      },
      "Option": {
        "StoreIconUrl": {},
        "CheckIconUrl": {},
        "NewIconUrl": "http:\/\/image.auctions.yahoo.co.jp\/i\/auctions\/new3.gif",
        "EscrowIconUrl": {},
        "FeaturedIconUrl": {},
        "FreeShippingIconUrl": {},
        "WrappingIconUrl": {},
        "BuynowIconUrl": {},
        "EasyPaymentIconUrl": {},
        "GiftIconUrl": {},
        "ItemStatusNewIconUrl": {},
        "YBankIconUrl": {},
        "EnglishIconUrl": {},
        "StarClubIconUrl": {},
        "CharityOptionIconUrl": {},
        "PointIconUrl": {},
        "IsBold": "false",
        "IsBackGroundColor": "false",
        "IsCharity": "false"
      }
    }]
  }
})


エラー

マイ・オークション表示（ウォッチリスト・開催中のオークション）はYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。



利用制限

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

目次

▼他のドキュメントを探す

Yahoo! JAPANの実験プロダクトを体験！「Yahoo!ラボ」

Yahoo! Open Local Platform
Yahoo!ウォレット FastPay