Keepa APIのレスポンスの1つ、「Lightning Deal Object」の公式レファレンスを日本語訳しました。
「Lightning Deals」は日本でいうと「タイムセール」に当たるプログラムです。
このレスポンスにはタイムセールの期間や割引される%などが取得できます。
開始時間の24時間前には情報を取得できるので、事前に商品に当たりをつけることができるのは良い点です。
タイムセールは基本数量限定ですしね。
それでは、↓から日本語訳スタートです！
- 「参考」で囲った部分は筆者の補足です。
- 適宜サブタイトルの追加や、意訳を実施しています。
- Keepaから翻訳の許可を頂いております。
こちら↓↓↓の記事に全てのKeepa APIに関する日本語訳記事をまとめているので、他のレファレンスも確認したい場合はご参考ください！
概要
Lightning Deal object は、Amazon Lightning Deal に関する情報を提供します。
ライトニング ディールは通常、開始の 24 時間前までに発表されます。
取引が開始されると、取引価格が含まれます。
Lightning Deal objectを返すリクエスト
Lightning Deal オブジェクトは、次のリクエストによって返されます: Lightning Deals Request
Lightning Deals Request は「Lightning Deals」 = 「タイムセール」を実施している or 実施する予定のASIN情報を取得するリクエストです。
500トークンでタイムセール中 or 予定のASINを全て取得できます！
詳しくは下記記事で解説しています。
レスポンスの形式
{
"domainId": Integer,
"lastUpdate": Integer,
"asin": String,
"title": String,
"sellerId": String,
"sellerName": String,
"dealId": String,
"dealPrice": Integer,
"currentPrice": Integer,
"image": String,
"isPrimeEligible": Boolean,
"isFulfilledByAmazon": Boolean,
"isMAP": Boolean,
"rating": Integer,
"totalReviews": Integer,
"dealState": String,
"startTime": Integer,
"endTime": Integer,
"percentClaimed": Integer,
"percentOff": Integer,
"variation": Object array
}domainId
このリストが属する Amazon ロケールの整数値。
可能な値: [ 1: com | 2: co.uk | 3: de | 4: fr | 5: co.jp | 6: ca | 8: it | 9: es | 10: in | 11:com.mx]
lastUpdate
このライトニング取引の最後のデータ収集の時間を Keepa Time 分単位で示します。
例: 2711319
asin
商品のASIN。
例: B00M0QVG3W
title
製品のタイトル。
注意: まれに、エスケープされていない HTML マークアップが含まれる場合があります。
例: Canon PowerShot SX400 デジタル カメラ (30 倍光学ズーム付き) (ブラック)
sellerId
この取引を提供している販売者のセラーID
例: A2L77EE7U53NWQ (Amazon.com Warehouse Deals)
sellerName
この取引を提案する販売者の名前
例: Amazon Warehouse Deals
dealId
この取引の一意の ID。
例: 76fbc441
dealPrice
この取引の割引価格。
取引が開始されたら利用可能になります。
取引の状態が近日中の場合は -1。
価格は、それぞれの Amazon ロケールの最小通貨単位の整数です (ユーロ セントや円など)。
例: 999
currentPrice
この商品の通常価格です。
取引が開始されたら利用可能になります。
取引の状態が近日中の場合は -1。
価格は、それぞれの Amazon ロケールの最小通貨単位の整数です (ユーロ セントや円など)。
例: 999
image
製品のプライマリ イメージの名前。
利用できない場合は null。
例: 51InzcaVqrL.jpg
Amazon イメージの完全なパスは下記のようになります :
https://images-na.ssl-images-amazon.com/images/I/<イメージ名>
isPrimeEligible
取引がプライム対象かどうかを示します。
isFulfilledByAmazon
取引が FBAかどうかを示します。
isMAP
価格がMAP（最低広告価格）によって制限されているかどうかを示します。
rating
製品の評価。評価は 0 ～ 50 の整数です
(例: 45 = 4.5 つ星)
totalReviews
商品のレビュー数。
dealState
取引の状態。可能な値:
※筆者注 日本語訳は筆者追記
- AVAILABLE
在庫あり - UPCOMING
近日入荷予定 - WAITLIST
待機リスト - SOLDOUT
売り切れ - WAITLISTFULL
待機リストいっぱい - EXPIRED
期限切れ - SUPPRESSED
販売停止
startTime
このライトニング ディールの開始時刻 (Keepa Time 分単位)。
データ収集に遅れが生じているため、Amazon で取引が開始されてもすぐには取引価格が表示されない可能性があることに注意してください。
例: 2711319
endTime
このライトニング ディールの終了時刻 (Keepa Time 分単位)。
例: 2711389
percentClaimed
ライトニング ディールで主張された割合(%)。ライトニング ディールの在庫には限りがあるため、この数値は Amazon ですぐに変更される可能性があり、さらにデータ収集の遅れにより提供される値が古くなっている可能性があります。
例: 23 (= 23% が主張されている)
percentOff
Amazon が示す、この取引に提供される割引。
割引は、現在の価格ではなく定価を参照して行われる場合があります。
例: 50 (= 50% 割引)
variation
この取引に関連付けられたディメンション属性。
例：
"variation": [{
"dimension": "Size",
"value": "Large"
}, {
"dimension": "Color",
"value": "Red"
}
]Keepa Time minutes について
すべてのタイムスタンプに使用される時刻形式です。
圧縮されていないタイムスタンプ (Unix エポック時間) に変換するには、21564000 を加算してから 60000 を掛けます (ミリ秒の場合、秒の場合は 60)。
以上です！
価格の割引%や評価数が分かるのはGood！
しかし、販売数などが必要な場合は別途Request Productsで取得する必要があります。
(リンクは当ブログ記事)
消費トークンなどリクエストの詳細については下記記事を参考にしてみてください。
