プログラミング PR

【Keepa APIの使い方】公式レファレンスを日本語訳してみました【Seller Object】

  /

Keepa APIのレスポンスの1つ、「Seller Object」の公式レファレンスを日本語訳しました。

出品セラーの情報を取得するリクエスト「Request Seller Information」の実行結果であり、セラーの評価数や出品しているASINの情報が中に入っています。

それでは、↓から日本語訳スタートです！

  • 「参考」で囲った部分は筆者の補足です。
  • 適宜サブタイトルの追加や、意訳を実施しています。
  • Keepaから翻訳の許可を頂いております。

こちら↓↓↓の記事に全てのKeepa APIに関する日本語訳記事をまとめているので、他のレファレンスも確認したい場合はご参考ください！

【Keepa APIの使い方】公式レファレンス日本語訳のまとめ 当ブログで投稿してきたKeepa APIの公式レファレンス(英語)の日本語訳解説のまとめ記事です。 Google翻訳でページ一括...
目次
  1. 概要
  2. Seller Objectを返すリクエスト
  3. レスポンスの形式

概要

seller objectは、Amazon マーケットプレイスのセラーに関する情報を提供します。

これには、名前、評価履歴、評価カウント履歴が含まれます。

API は、ハンドメイド カテゴリのみで販売している出品者には情報を提供しません。

Seller Objectを返すリクエスト

セラー オブジェクトは、次のリクエストによって返されます: Request Seller Information

Request Seller Informationはセラーの評価数や出品ASINなどを取得できるリクエストです。

上記リンクは公式レファレンス(英語)へのリンクですが、当ブログで日本語訳した記事もありますのでご参考ください。

【Keepa APIの使い方】公式レファレンスを日本語訳してみました【Request Seller Information】 Keepa APIのリクエストの1つ、「Request Seller Information」の公式レファレンスを日本語訳しました。 ...

レスポンスの形式

{
    "domainId": Integer,
    "trackingSince": Integer,
    "lastUpdate": Integer,
    "sellerId": String,
    "sellerName": String,
    "businessName": String,
    "address": String array,
    "tradeNumber": String,
    "vatID": String,
    "phoneNumber": String,
    "businessType": String,
    "shareCapital": String,
    "email": String,
    "representative": String,
    "customerServicesAddress": String array,
    "lastRatingUpdate": Integer,
    "ratingCount": Integer array,
    "positiveRating": Integer array,
    "negativeRating": Integer array,
    "neutralRating": Integer array,
    "recentFeedback": Feedback Object array,
    "isScammer": Boolean,
    "shipsFromChina": Boolean,
    "hasFBA": Boolean,
    "totalStorefrontAsins": Integer array
    "csv": two dimensional Integer array,
    "asinList": String array,
    "asinListLastSeen": Integer array
    "sellerCategoryStatistics": 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]

trackingSince

この出品者の追跡を開始した時間を Keepa Time 分単位で示します。

例: 2700145

lastUpdate

このセラーの基本データが最後に更新された時刻 (Keepa Time 分)。

これには、評価やストアフロントのデータは含まれません。

例: 2711319

評価の最終更新時刻は lastRatingUpdate で取得できます！

sellerId

マーチャントのセラー ID。

例: A2L77EE7U53NWQ ((Amazon.com Warehouse Deals)

sellerName

セラーの名前

例: Amazon Warehouse Deals

businessName

ビジネスの名前。

例: Keepa GmbH

address

会社の住所。

配列の各エントリには、1 つの住所行が含まれます。
最後のエントリには、2 文字の国コードが含まれています。

利用できない場合は null。

例: [123 Main Street, New York, NY, 10001, US]

tradeNumber

取引登録番号。

利用できない場合は null。

vatID

VAT番号(付加価値税番号)。

利用できない場合は null。

phoneNumber

電話番号。利用できない場合は null。

例: 800 1234 567

businessType

ビジネス タイプ。

利用できない場合は null。

例: Unternehmen in Privatbesitz

shareCapital

株式資本。

利用できない場合は null。

例: 25000

email

ビジネスの電子メール アドレス。
このフィールドは、値がある場合にのみ応答に表示されます。

例: info@keepa.com

representative

ビジネス代表者の名前。

利用できない場合は null。

例: Max Mustermann

customerServicesAddress

カスタマー サービスの住所。

配列の各エントリには、1 つの住所行が含まれます。
最後のエントリには、2 文字の国コードが含まれています。

利用できない場合は null。

例: [123 Main Street, New York, NY, 10001, US]

lastRatingUpdate

このセラーの評価データが最後に更新された時刻を Keepa Time 分で示します。

例: 2711319

ratingCount

過去 30 日間、90 日間、365 日間、全期間の評価数がこの順序で含まれます。

例: [3、10、98、321]

positiveRating

過去 30 日間、90 日間、365 日間、全期間の肯定的な割合の評価がこの順序で含まれています。
肯定的な評価は、4 つ星または 5 つ星の評価です。

例: [96、98、98、95]

negativeRating

過去 30 日間、90 日間、365 日間、全期間の否定的な割合の評価がこの順序で含まれています。
マイナスの評価は、1 つまたは 2 つの星の評価です。

例: [3、1、1、3]

neutralRating

過去 30 日間、90 日間、365 日間、全期間のニュートラルな割合の評価がこの順序で含まれます。
ニュートラル評価は 3 つ星評価です。

例: [1、1、1、2]

recentFeedback

最新のお客様からのフィードバックが最大 5 件含まれています。
配列内の各フィードバック オブジェクトには、次のフィールドが含まれます。

  • date (整数): フィードバックのタイムスタンプ (Keepa Time 分単位)。
  • rating (整数): フィードバックの星の評価 – 値の範囲は 10 (星 1 つ) から 50 (星 5 つ) です。
  • feedback (文字列): フィードバック テキスト
  • isStriked (ブール値): フィードバックがストライクされたかどうか

最後の isStriked ですが、おそらく評価が削除されているかどうかだと思います。

例えば↓の画像で取り消し線が引いてあるコメントです。

isScammer

この販売者がユーザーを詐欺しようとしていることをシステムが識別したかどうかを示すブール値。

例: false

shipsFromChina

この出品者が中国から発送するかどうかを示すブール値。

例: false

余談

わざわざ中国発送セラーかを判別する項目があるのが面白いですね(笑)。

どの国でも中国セラーが猛威を奮っていることが伺えます。

hasFBA

出品者が現在 FBA (Fulfillment by Amazon) に出品しているかどうかを示すブール値。

通常、この値は正しいですが、すべての出品者のリストを常に把握しているわけではないため、出品者が FBA 出品を行っている場合でも false に設定される可能性があります。
これは特に、売れ行きの悪い製品で構成されたリストがわずかしかないセラーの場合に当てはまります。

例: true

csv

この販売者の履歴データを含む 2 次元の履歴配列。

  • 最初の次元のインデックス:
    • 0 – RATING: 販売者のパーセントでの評価、0 から 100 までの整数。
    • 1 – RATING_COUNT: 販売者の合計評価数、整数。
  • 2 番目の次元には、Keepa time分、値、[…] の形式で履歴が含まれます。
    利用可能なデータがない場合は null です。
    新しく作成されたマーチャント アカウントには、まだ評価がない場合があります。

    例：
    最新の評価: csv[0][csv[0].length – 1]
    最新の評価数: csv[1][csv[1].length – 1]

totalStorefrontAsins

ストアフロント ASIN の数 (利用可能な場合) と、その指標の最終更新が含まれます。
利用できない場合は null (ストアフロントが取得されたことがない)。

このフィールドは、デフォルトのRequest Seller Informationで使用できます (storefront パラメータは必須ではありません)。

形式は次のとおりです。
[Keepa Time 分での最終更新、ストアフロント ASIN の数]。

例: [2711319, 1200]

Request Seller Informationのstorefront パラメータについて

storefront パラメータを使用するとセラーが出品しているASINが分かりますが、消費トークン1トークン→10トークンに劇的に増加します。

出品数までなら少ないトークンで分かるということですね。

asinList

最大 100,000 のストアフロント ASIN を含む文字列配列で、新しい順に並べ替えられます。
対応するタイムスタンプは asinListLastSeen フィールドにあります。

storefront パラメーターが使用された場合にのみ使用できます。

このフィールドの詳細については、seller request の storefront パラメータを参照してください。

storefrontパラメータについて、参考に当ブログのリンクも載せておきます。

【Keepa APIの使い方】公式レファレンスを日本語訳してみました【Request Seller Information】 Keepa APIのリクエストの1つ、「Request Seller Information」の公式レファレンスを日本語訳しました。 ...

asinListLastSeen

asinList フィールドの各 ASIN を最後に検証できた時間 (Keepa Time 分単位) が含まれます。

asinList と asinListLastSeen は同じ索引付けを共有するため、asinList[10] の対応するタイムスタンプは asinListLastSeen[10] になります。

例：[2711319、2711311]

sellerCategoryStatistics

この出品者の主なカテゴリに関する統計。
多くの場合、不完全で古い製品オファー データに基づいています。

配列内の各オブジェクトには、次のフィールドが含まれています。

  • catId (Long): カテゴリ ID
  • productCount (整数): このマーチャントがこのブランドで販売する製品の数
  • avg30SalesRank (整数): これらの製品の 30 日間の平均販売ランク
  • productCountWithAmazonOffer (整数): これらの製品のうち、Amazon オファーがある製品の数

sellerBrandStatistics

この出品者の主なブランドに関する統計。
多くの場合、不完全で古い製品オファー データに基づいています。

配列内の各オブジェクトには、次のフィールドが含まれています。

  • brand (文字列): ブランド (すべて小文字)
  • productCount (整数): このマーチャントがこのブランドで販売する製品の数
  • avg30SalesRank (整数): これらの製品の 30 日間の平均販売ランク
  • productCountWithAmazonOffer (整数): これらの製品のうち、Amazon オファーがある製品の数
Keepa Time minutes について

すべてのタイムスタンプに使用される時刻形式です。
圧縮されていないタイムスタンプ (Unix エポック時間) に変換するには、21564000 を加算してから 60000 を掛けます (ミリ秒の場合、秒の場合は 60)。

以上です！

セラーの評価数やセラーIDがわかることもさることながら、出品しているASINが取得できるのが強いです。

その分ASINのリストを取得すると、トークン消費が激しくなります。

消費トークンなどリクエストの詳細については下記記事を参考にしてみてください。

【Keepa APIの使い方】公式レファレンスを日本語訳してみました【Request Seller Information】 Keepa APIのリクエストの1つ、「Request Seller Information」の公式レファレンスを日本語訳しました。 ...
Keepa
RELATED POST