オークション

商品詳細

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

こちらのAPIは、2015年4月15日に終了させていただきました。最新バージョンのAPIをご利用ください。

ヤフオク!の商品詳細データを提供します。

リクエストパラメータ

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

パラメータ 説明
appid(必須) string アプリケーションID。詳細はこちらをご覧ください。
auctionID(必須) string 商品(オークション)のIDです。

サンプルリクエストURL

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


レスポンスフィールド

商品詳細のスキーマの記述は、以下のURLをご覧ください。
http://auctions.yahooapis.jp/AuctionWebService/V1/AuctionItem.xsd

 
フィールド 説明
AuctionItem クエリーレスポンスのすべてを含みます。
auctionID 商品(オークション)のIDです。
categoryID このカテゴリのIDです。
categoryPath このカテゴリの最上位カテゴリからのパスです。
title 商品(オークション)のタイトルです。
url 商品(オークション)のURLです。入札はこのURLに遷移して行っていただくことが必要です。
seller 出品者に関する情報です。
id 出品者のYahoo! JAPAN IDです。
location 出品地域です。
itemlist この出品者の出品リストを取得するリクエストURLです。(appidは含まれていませんのでご注意ください)
rating この出品者の評価のページのURLです。
img 画像(サムネイル)のURLです。
image1 画像1のURLです。次の属性を持ちます。
  • width: この画像の幅
  • height: この画像の高さ
image2 画像2のURLです。次の属性を持ちます。
  • width: この画像の幅
  • height: この画像の高さ
image3 画像3のURLです。次の属性を持ちます。
  • width: この画像の幅
  • height: この画像の高さ
initprice 開始価格です。
price 現在価格です。
bidinc 入札単位です。
quantity 商品の数量です。
bids 現在の入札数です。
starttime オークションの開始日時です。
endtime オークションの終了日時です。
timeleft オークションの残り時間です。
bidorbuy 希望落札価格です。(設定されていない場合は要素なし)
reserved 最低落札価格の有無です。(設定されていない場合は要素なし)
option 商品(オークション)にオプションが設定されている場合、そのオプションのアイコン(GIFファイル)のURLを示します。
store 「ストア」アイコンのURLです。
check 「鑑定済み」アイコンのURLです。
public 「公売」アイコンのURLです。
freeshipping 「送料無料」のアイコンのURLです。
wrappingicon 「贈答品」アイコンのURLです。
buynow 「即買」アイコンのURLです。
easypayment 「Yahoo!かんたん決済」アイコンのURLです。
largeimg 「特大画像」アイコンのURLです。
gift_icon 「目立ち」アイコンのURLです。
description 商品説明です。データ形式はCDATAとなり、出品者が商品説明として記述した内容がそのまま提供されます。商品説明がHTMLで記述されている場合はHTMLのタグも含まれます。



サンプルレスポンス

以下は、auctionID=32259 のクエリーの結果です。

<AuctionItem xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:jp:auc:item" 
 xsi:schemaLocation="urn:yahoo:jp:auc:item http://auctions.yahooapis.jp/AuctionWebService/V1/AuctionItem.xsd">
  <auctionID>32259</auctionID> 
  <categoryID>23564</categoryID> 
  <categoryPath>オークション > コンピュータ > その他</categoryPath> 
  <title>商品タイトルタイトルタイトル</title> 
  <seller>
  <id>xyz_123456</id> 
  <location>東京都</location> 
  <itemlist>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=xyz_123456</itemlist> 
  <rating>http://rating1.auctions.yahoo.co.jp/jp/show/rating?userID=xyz_123456</rating> 
  </seller>
  <img /> 
  <initprice>100 円</initprice> 
  <price>100 円</price> 
  <bids>0</bids> 
  <starttime>6月 15日 16時 10分</starttime> 
  <endtime>6月 20日 16時 10分</endtime> 
  <timeleft>4 日</timeleft> 
  <bidorbuy /> 
  <option>
    <easypayment>http://i.yimg.jp/images/pay/icon_s16.gif</easypayment> 
    <largeimg>http://image.auctions.yahoo.co.jp/images/zooma.gif</largeimg> 
    </option>
  <description>
    <![CDATA[  商品説明商品説明商品説明 
    ]]> 
  </description>
</AuctionItem>



エラー

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