オークション

すべての入札履歴

リクエストURL
XML
http://auctions.yahooapis.jp/AuctionWebService/V1/BidHistoryDetail

ヤフオク!のすべての入札履歴の表示機能を提供します。

リクエストパラメータ

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

パラメータ 説明
appid(必須) string アプリケーションID。詳細はこちらをご覧ください。
output string XML、PHPserialize、JSONPでレスポンスの出し別けを行います。
  • xml :xmlレスポンス(デフォルト)
  • php :PHPserializeレスポンス
  • json :JSONPレスポンス
callback string JSONPとして出力する際のコールバック関数名を入力するためのパラメータです。UTF-8でエンコードした文字列を入力します。
auctionID(必須) string 入札履歴情報取得を実施する対象のオークションIDです。
page integer:1(デフォルト) 入札履歴のページ番号です。デフォルトは1となり最初のページを返します。

サンプルリクエストURL

http://auctions.yahooapis.jp/AuctionWebService/V1/BidHistoryDetail?appid=<あなたのアプリケーションID>&auctionID=<商品(オークション)のID>


レスポンスフィールド

すべての入札履歴APIのスキーマの記述は、以下になります。

フィールド 説明
/ResultSet クエリーレスポンスのすべてを含みます。
  • totalResultsAvailable: 該当件数の総個数です。(1固定)
  • totalResultsReturned: 返された値の個数です。(1固定)
  • firstResultPosition: 最初のデータが何個目にあたるかです。(1固定)
/ResultSet/Result 各個別レスポンスを含みます。
/ResultSet/Result/Bidder 入札者のYahoo! JAPAN IDです。
/ResultSet/Result/Rating 評価を表現するフィールドです。
/ResultSet/Result/Rating/Point 評価ポイントです。新規または今までの評価ポイント総計が0の場合は、0を設定します。新規かどうかを判別する場合は「IsNotRated」をご利用ください。
/ResultSet/Result/Rating/IsNotRated【NEW】 新規の際にtrueとなります。
/ResultSet/Result/Rating/IsSuspended 停止中の際、trueとなります。
/ResultSet/Result/Rating/IsDeleted 登録削除済みの際、trueとなります。
/ResultSet/Result/Price 現在の価格(入札価格)です。
  • isPriceMask:価格マスクされているか。あり(価格を提供しない)の際、trueとなります。
/ResultSet/Result/Quantity 入札した個数です。
/ResultSet/Result/Date 最後に手動入札した時間です。RFC3339に準拠した表現を用います。(例:2004-04-01T12:00:00+09:00)
/ResultSet/Result/ItemListURL 入札者の出品リストへのリクエストURLです。
/ResultSet/Result/RatingURL 入札者の評価ページへのURLです。
/ResultSet/Result/TextLine すべての入札履歴の文字列です。
例:オークション開始。数量: 1 で 1
abc***** 入札。数量: 1 で 1
/ResultSet/Result/IsCanceled 入札取り消しの際にtrue、それ以外はfalseとなります。
/ResultSet/Result/IsAutomatically 自動入札の際はtrue、手動入札の際はfalseとなります。



サンプルレスポンス

<ResultSet totalResultsAvailable="6" totalResultsReturned="6" firstResultPosition="1">
  <Result>
    <Bidder>mas*****</Bidder>
    <Rating>
      <Point>612</Point>
      <IsNotRated>false</IsNotRated>
      <IsSuspended>false</IsSuspended>
      <IsDeleted>false</IsDeleted>
    </Rating>
    <Price isPriceMask="false">1200.00</Price>
    <Date>2013-02-23T22:14:00+09:00</Date>
    <TextLine>mas***** 自動入札。 1,200</TextLine>
    <IsAutomatically>true</IsAutomatically>
    <IsCanceled>false</IsCanceled>
  </Result>
  <Result>
    <Bidder>mas*****</Bidder>
    <Rating>
      <Point>612</Point>
      <IsNotRated>false</IsNotRated>
      <IsSuspended>false</IsSuspended>
      <IsDeleted>false</IsDeleted>
    </Rating>
    <Price isPriceMask="false">1100.00</Price>
    <Quantity>1</Quantity>
    <Date>2013-02-23T22:14:00+09:00</Date>
    <TextLine>mas***** 入札。数量: 1 で 1,100</TextLine>
    <IsAutomatically>false</IsAutomatically>
    <IsCanceled>false</IsCanceled>
  </Result>
  <Result>
    <Bidder>blo*****</Bidder>
    <Rating>
      <Point>145</Point>
      <IsNotRated>false</IsNotRated>
      <IsSuspended>false</IsSuspended>
      <IsDeleted>false</IsDeleted>
    </Rating>
    <Price isPriceMask="false">1100.00</Price>
    <Date>2013-02-23T09:35:00+09:00</Date>
    <TextLine>blo***** 自動入札。 1,100</TextLine>
    <IsAutomatically>true</IsAutomatically>
    <IsCanceled>false</IsCanceled>
  </Result>
  <Result>
    <Bidder>blo*****</Bidder>
    <Rating>
      <Point>145</Point>
      <IsNotRated>false</IsNotRated>
      <IsSuspended>false</IsSuspended>
      <IsDeleted>false</IsDeleted>
    </Rating>
    <Price isPriceMask="false">1000.00</Price>
    <Quantity>1</Quantity>
    <Date>2013-02-23T09:35:00+09:00</Date>
    <TextLine>blo***** 入札。数量: 1 で 1,000</TextLine>
    <IsAutomatically>false</IsAutomatically>
    <IsCanceled>false</IsCanceled>
  </Result>
  <Result>
    <Bidder>nen*****</Bidder>
    <Rating>
      <Point>467</Point>
      <IsNotRated>false</IsNotRated>
      <IsSuspended>false</IsSuspended>
      <IsDeleted>false</IsDeleted>
    </Rating>
    <Price isPriceMask="false">1000.00</Price>
    <Quantity>1</Quantity>
    <Date>2013-02-23T00:26:00+09:00</Date>
    <TextLine>nen***** 入札。数量: 1 で 1,000</TextLine>
    <IsAutomatically>false</IsAutomatically>
    <IsCanceled>false</IsCanceled>
  </Result>
  <Result>
    <Price isPriceMask="false">1000.00</Price>
    <Quantity>1</Quantity>
    <Date>2013-02-22T13:45:00+09:00</Date>
    <TextLine>オークション開始。数量: 1 で 1,000</TextLine>
    <IsAutomatically>false</IsAutomatically>
    <IsCanceled>false</IsCanceled>
  </Result>
</ResultSet>

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

a: 1: {
  s: 9: "ResultSet";
  a: 4: {
    s: 21: "totalResultsAvailable";
    s: 1: "6";
    s: 20: "totalResultsReturned";
    s: 1: "6";
    s: 19: "firstResultPosition";
    s: 1: "1";
    s: 6: "Result";
    a: 6: {
      i: 0;
      a: 8: {
        s: 6: "Bidder";
        s: 8: "mas*****";
        s: 6: "Rating";
        a: 3: {
          s: 5: "Point";
          s: 3: "612";
          s: 10: "IsNotRated";
          s: 5: "false";
          s: 11: "IsSuspended";
          b: 0;
          s: 9: "IsDeleted";
          b: 0;
        }
        s: 5: "Price";
        s: 7: "1200.00";
        s: 16: "PriceIsPriceMask";
        s: 5: "false";
        s: 4: "Date";
        s: 28: "
2013-02-23T22:14:00+09:00		";
        s: 8: "TextLine";
        s: 30: "mas***** 自動入札。 1,200";
        s: 15: "IsAutomatically";
        b: 1;
        s: 10: "IsCanceled";
        b: 0;
      }
      i: 1;
      a: 9: {
        s: 6: "Bidder";
        s: 8: "mas*****";
        s: 6: "Rating";
        a: 3: {
          s: 5: "Point";
          s: 3: "612";
          s: 10: "IsNotRated";
          s: 5: "false";
          s: 11: "IsSuspended";
          b: 0;
          s: 9: "IsDeleted";
          b: 0;
        }
        s: 5: "Price";
        s: 7: "1100.00";
        s: 16: "PriceIsPriceMask";
        s: 5: "false";
        s: 8: "Quantity";
        s: 1: "1";
        s: 4: "Date";
        s: 28: "
2013-02-23T22:14:00+09:00		";
        s: 8: "TextLine";
        s: 39: "mas***** 入札。数量: 1 で 1,100";
        s: 15: "IsAutomatically";
        b: 0;
        s: 10: "IsCanceled";
        b: 0;
      }
      i: 2;
      a: 8: {
        s: 6: "Bidder";
        s: 8: "blo*****";
        s: 6: "Rating";
        a: 3: {
          s: 5: "Point";
          s: 3: "145";
          s: 10: "IsNotRated";
          s: 5: "false";
          s: 11: "IsSuspended";
          b: 0;
          s: 9: "IsDeleted";
          b: 0;
        }
        s: 5: "Price";
        s: 7: "1100.00";
        s: 16: "PriceIsPriceMask";
        s: 5: "false";
        s: 4: "Date";
        s: 28: "
2013-02-23T09:35:00+09:00		";
        s: 8: "TextLine";
        s: 30: "blo***** 自動入札。 1,100";
        s: 15: "IsAutomatically";
        b: 1;
        s: 10: "IsCanceled";
        b: 0;
      }
      i: 3;
      a: 9: {
        s: 6: "Bidder";
        s: 8: "blo*****";
        s: 6: "Rating";
        a: 3: {
          s: 5: "Point";
          s: 3: "145";
          s: 10: "IsNotRated";
          s: 5: "false";
          s: 11: "IsSuspended";
          b: 0;
          s: 9: "IsDeleted";
          b: 0;
        }
        s: 5: "Price";
        s: 7: "1000.00";
        s: 16: "PriceIsPriceMask";
        s: 5: "false";
        s: 8: "Quantity";
        s: 1: "1";
        s: 4: "Date";
        s: 28: "
2013-02-23T09:35:00+09:00		";
        s: 8: "TextLine";
        s: 39: "blo***** 入札。数量: 1 で 1,000";
        s: 15: "IsAutomatically";
        b: 0;
        s: 10: "IsCanceled";
        b: 0;
      }
      i: 4;
      a: 9: {
        s: 6: "Bidder";
        s: 8: "nen*****";
        s: 6: "Rating";
        a: 3: {
          s: 5: "Point";
          s: 3: "467";
          s: 10: "IsNotRated";
          s: 5: "false";
          s: 11: "IsSuspended";
          b: 0;
          s: 9: "IsDeleted";
          b: 0;
        }
        s: 5: "Price";
        s: 7: "1000.00";
        s: 16: "PriceIsPriceMask";
        s: 5: "false";
        s: 8: "Quantity";
        s: 1: "1";
        s: 4: "Date";
        s: 28: "
2013-02-23T00:26:00+09:00		";
        s: 8: "TextLine";
        s: 39: "nen***** 入札。数量: 1 で 1,000";
        s: 15: "IsAutomatically";
        b: 0;
        s: 10: "IsCanceled";
        b: 0;
      }
      i: 5;
      a: 7: {
        s: 5: "Price";
        s: 7: "1000.00";
        s: 16: "PriceIsPriceMask";
        s: 5: "false";
        s: 8: "Quantity";
        s: 1: "1";
        s: 4: "Date";
        s: 28: "
2013-02-22T13:45:00+09:00		";
        s: 8: "TextLine";
        s: 48: "オークション開始。数量: 1 で 1,000";
        s: 15: "IsAutomatically";
        b: 0;
        s: 10: "IsCanceled";
        b: 0;
      }
    }
  }
}

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

loaded({
  ResultSet: {@attributes: {
      totalResultsAvailable: "6",
      totalResultsReturned: "6",
      firstResultPosition: "1"
    },
    Result: [{
      Bidder: "mas*****",
      Rating: {
        Point: "612",
        IsNotRated: "false",
        IsSuspended: "false",
        IsDeleted: "false"
      },
      Price: "1200.00",
      Date: " 2013-02-23T22:14:00+09:00	 ",
      TextLine: "mas***** 自動入札。 1,200",
      IsAutomatically: "true",
      IsCanceled: "false"
    }, {
      Bidder: "mas*****",
      Rating: {
        Point: "612",
        IsNotRated: "false",
        IsSuspended: "false",
        IsDeleted: "false"
      },
      Price: "1100.00",
      Quantity: "1",
      Date: " 2013-02-23T22:14:00+09:00	 ",
      TextLine: "mas***** 入札。数量: 1 で 1,100",
      IsAutomatically: "false",
      IsCanceled: "false"
    }, {
      Bidder: "blo*****",
      Rating: {
        Point: "145",
        IsNotRated: "false",
        IsSuspended: "false",
        IsDeleted: "false"
      },
      Price: "1100.00",
      Date: " 2013-02-23T09:35:00+09:00	 ",
      TextLine: "blo***** 自動入札。 1,100",
      IsAutomatically: "true",
      IsCanceled: "false"
    }, {
      Bidder: "blo*****",
      Rating: {
        Point: "145",
        IsNotRated: "false",
        IsSuspended: "false",
        IsDeleted: "false"
      },
      Price: "1000.00",
      Quantity: "1",
      Date: " 2013-02-23T09:35:00+09:00	 ",
      TextLine: "blo***** 入札。数量: 1 で 1,000",
      IsAutomatically: "false",
      IsCanceled: "false"
    }, {
      Bidder: "nen*****",
      Rating: {
        Point: "467",
        IsNotRated: "false",
        IsSuspended: "false",
        IsDeleted: "false"
      },
      Price: "1000.00",
      Quantity: "1",
      Date: " 2013-02-23T00:26:00+09:00	 ",
      TextLine: "nen***** 入札。数量: 1 で 1,000",
      IsAutomatically: "false",
      IsCanceled: "false"
    }, {
      Price: "1000.00",
      Quantity: "1",
      Date: " 2013-02-22T13:45:00+09:00	 ",
      TextLine: "オークション開始。数量: 1 で 1,000",
      IsAutomatically: "false",
      IsCanceled: "false"
    }]
  }
})



エラー

すべての入札履歴はYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。