Keepa APIのレスポンスの1つ、「Marketplace Offer Object」の公式レファレンスを日本語訳しました。
商品情報を検索するリクエスト「Request Products」の実行結果であり、商品出品者一覧に表示される情報を取得できます。
有用そうなところだと、
- セラーID
- 送料
が取得できますね。
それでは、↓から日本語訳スタートです！
- 「参考」で囲った部分は筆者の補足です。
- 適宜サブタイトルの追加や、意訳を実施しています。
- Keepaから翻訳の許可を頂いております。
こちら↓↓↓の記事に全てのKeepa APIに関する日本語訳記事をまとめているので、他のレファレンスも確認したい場合はご参考ください！
概要
offer オブジェクトは、マーケットプレイスのオファーを表します。
Marketplace Offer Objectを返すリクエスト
Marketplace Offer Objectは、オプションのoffers パラメータを使用してProduct Requestによって返され、Product Objectの一部です。
商品情報を取得するProduct Requestのレスポンスの一部です。
Product Requestの実行パラメータ等は下記記事でまとめています！
また、一緒に返される他のレスポンスの情報(販売数や商品サイズなど)は下記記事でまとめているのでご参考ください。
重要なポイント
何十億ものマーケットプレイスのオファーを定期的に更新することは不可能です。
製品リクエストのオファー パラメータは、取得/更新するオファーの数を決定します。
すべての条件で、Amazon によって並べ替えられた最高のオファーを常に取得します。
商品に要求されたよりも多くのオファーがある場合、それらは取得されません。
オファーの順序は常に変化し、データを取得するたびに異なる量のオファーを取得できます。
これと、オファーの履歴を保持しているという事実により、ほぼ確実に古いオファーに遭遇することになります。 したがって、次のことが重要です。
- lastSeen フィールドを評価することで、過去のオファーに関心がない場合は、新鮮でアクティブなオファーのみを処理します。
または、商品オブジェクトの liveOffersOrder フィールドを使用できます。 - オファーの履歴 (過去の価格と送料) には、多くの場合、ギャップがないわけではありません。
製品オブジェクトの EXTRA_INFO_UPDATES csv タイプを評価して、いつオファーを更新したかを確認します。
製品の (すべての) オファーを完全にカバーする必要がある場合は、定期的にリクエストする必要があります。
ほぼ同一の出品者、同じ状態、同じ配送タイプ、同じ状態のテキストがある場合、最も安い価格の商品のみを提供します。
重複は記載しません。
レスポンスの形式
{
"offerId": Integer,
"lastSeen": Integer,
"sellerId": String,
"isPrime": Boolean,
"isFBA": Boolean,
"isMAP": Boolean,
"isShippable": Boolean,
"isAddonItem": Boolean,
"isPreorder": Boolean,
"isWarehouseDeal": Boolean,
"isScam": Boolean,
"shipsFromChina": Boolean,
"isAmazon": Boolean,
"isPrimeExcl": Boolean,
"coupon": Integer,
"condition": Integer,
"minOrderQty": Integer,
"conditionComment": String,
"offerCSV": Integer array,
"primeExclCSV": Integer array
}offerId
このオファーの一意の ID (製品の範囲内)。
Amazon が使用する offerId とは関係ありません。
これらはユーザー固有であり、短期間しか有効ではないためです。
offerId を使用して、リクエスト全体で同じオファーを識別できます。
例: 4
lastSeen
当社がこのオファーを最後に見た (および更新した) 時刻を、Keepa Time の分単位で示します。
現存するオファーのみに関心がある場合は、このフィールドを使用してオファーが最新であることを確認します。
例: 2700145
sellerId
出品者のセラー ID。
例 : A2L77EE7U53NWQ(Amazon.com Warehouse Deals)
isPrime
このオファーがプライム配送で利用できるかどうか。
Keepa は SFP (Seller Fulfilled Prime) を識別できません。
したがって、これはAmazonによるフルフィルメントにのみ当てはまります。
例 : true
isFBA
このオファーがAmazonによって履行されるかどうか。
例: true
isMAP
MAP (「最低広告価格」) 制限により、このオファーの価格が Amazon で非表示になっている場合。
その場合でも、オファー オブジェクトには価格と送料が含まれます。
例 : false
isShippable
オファーが現在出荷可能かどうかを示すブール値。
そうでない場合は、例えば一時的に在庫がないか、予約注文となっている可能性があります。
例: true
isAddonItem
Add-on itemであるかどうかを示します。
例 : false
日本でAdd-on itemにドンピシャ当てはまるモノはなさそうです…。
ただ内容としては、日本でもたまにある「〇〇円以上じゃないと購入できない」商品が近そうです。
そのような商品がisAddonItemがtrueになるかは要検証ですね。
isPreorder
オファーが予約注文かどうかを示します。
例: false
isWarehouseDeal
オファーが Warehouse Deal であるかどうかを示します。
例: false
Warehouse Dealって？
日本でいう「Amazonアウトレット」に相当する販売者のことです。
返品されて新品としては販売できないけど状態が良い商品などを販売する、Amazon公式のショップですね。
isScam
提供しているマーチャントがユーザーを詐欺しようとしていることをシステムが識別したかどうかを示すブール値。
例: false
scamは「詐欺」という意味です。
こんな項目もあるんだと感心しちゃいますね。
しかし、どうやって判別しているのか気になる…。
shipsFromChina
この商品が中国から発送されたかどうかを示すブール値。
例: false
isAmazon
販売者が Amazon の場合は true (例: Amazon.com)。
注: Amazon の Warehouse Deals 出品者アカウント、または Amazon が別の名前で維持しているその他のアカウントは、Amazon とは見なされません。
例: false
isPrimeExcl
このオファーには、割引されたプライム限定価格があります。
例: false
coupon
このオファーの 1 回限りのクーポンの詳細が含まれています。
利用できない場合は未定義。
絶対割引の場合は正の整数、パーセンテージ割引の場合は負の整数。
例：
500 – 5 ドル割引のクーポン。
-15 – 15% 割引のクーポン。
minOrderQty
最小注文数量。
このフィールドは、値がある場合にのみ応答に表示されます。
例 : 2
condition
出品商品の状態。整数値:
- 0 – 不明: 状態を特定できません
- 1 – 新品
- 2 – 中古 – ほぼ新品
- 3 – 中古 – 非常に良い
- 4 – 中古 – 良い
- 5 – 中古 – 可
- 6 – 修理済み
- 7 – コレクター向け – ほぼ新品
- 8 – コレクター向け – 非常に良い
- 9 – コレクター向け – 良い
- 10 – コレクター向け – 可
- 11 – レンタル
- 注: オープン ボックスの状態は、中古の状態としてコード化されています。
conditionComment
コンディションの説明テキスト。
例：商品は再梱包される場合があります。上の小さな化粧上の欠陥、[…]
offerCSV
オファーの現在の価格と送料、および可能な場合はオファーの履歴が含まれます。
Keepa の時間分、価格、送料、[…] という形式です。
- 価格と配送料は、それぞれの Amazon ロケールの最小通貨単位 (例: ユーロ セントまたは円) の整数です。
- 価格または送料を決定できなかった場合、値は -2 になります。
- 送料無料は送料0円です。
- オファーが発送不可または送料が指定されていない場合、送料は -1 になります。
- 最新の価格と送料を取得するには、配列の最後の 2 つのエントリにアクセスします。
・最新の価格: offerCSV[offerCSV.length – 2]
・最新の送料: offerCSV[offerCSV.length – 1]
primeExclCSV
利用可能な場合、このオファーのプライム限定価格履歴が含まれます。
Prime 限定オファーは、購入者が有効な Prime サブスクリプションを持っている場合にのみ注文できます。
Keepa 時間分、価格、[…] の形式です。
- 価格は、それぞれの Amazon ロケールの最小通貨単位 (例: ユーロ セントまたは円) の整数です。
- プライム限定価格が存在しない場合、価格は -1 になるか、フィールドは null になります。
- 最新のプライム限定価格を取得するには:
・primeExclCSV[primeExclCSV.length – 1]
Keepa Time minutesとは？
すべてのタイムスタンプに使用される時刻形式です。
圧縮されていないタイムスタンプ (Unix エポック時間) に変換するには、21564000 を加算してから 60000 を掛けます (ミリ秒の場合、または秒の場合は 60)。
以上です！
送料が取得できるので、正確な販売価格がわかるのがGood!!
セラーIDもわかるので、利益商品を出品するセラーをリスト化するのにも使用できますね。
消費トークンなどリクエストの詳細については下記記事を参考にしてみてください。
また、一緒に返される他のレスポンスの情報(販売数や商品サイズなど)は下記記事でまとめているのでご参考ください。
