製品バリエーションのクエリキューに親 ASIN を追加
親 ASIN を製品バリエーションのクエリ キューに追加するリクエスト。
クレジット控除
データの取得が成功した後、バリアントごとに 1 クレジットが差し引かれます。 例: 5 つのバリエーションがある場合、5 つのバリエーション情報がすべて正常に取得された場合、5 クレジットが差し引かれます。
要求
| URI | /api/query/requestvariants/ {PARENTASIN}?domain={domain}&secretKey={secretKey} | {PARENTASIN } – 必須 – バリアント検索キューに追加する親 ASIN {domain} – オプション – 指定しない場合、デフォルトは www.amazon.com です。 見る サポートされている Amazon ドメイン リスト用。 |
| HTTP ヘッダー (オプション) | AMZPECTY_CALLBACK_URL={コールバック URL} | |
| 例 | /api/query/requestvariants/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
応答
| ヘッダ | |
| メディアタイプ | アプリケーション/ json |
| JSONデータ |
JSONの
{
"status": "OK",
"allowed": 999,
"dailyAllowed": 100,
"messageId": null,
"message": null,
"data": null,
"rid": "5e70778ce4b09ae7cdd98243",
"dateProcessed": null
}製品バリエーション クエリコールバック
製品バリエーション クエリ コールバック リクエスト
| URI | 例: https://your.server.com/amzpecty_result | {設定ページに URL を入力してください} URL は SSL が有効になっている必要があります。 AMZPECTY-API-SECRET-KEY (ヘッダー名) – コールバック サーバーがリクエストの発信元を検証するために秘密キー ヘッダーが含まれます。 |
| メディアタイプ | アプリケーション/ json |
製品バリエーション クエリ コールバック JSON サンプル データ
| ヘッダ | |
| メディアタイプ | アプリケーション/ json |
| JSONデータ |
JSONの
{
"status": "OK",
"responsefor": "productvariations",
"allowed": 142658,
"dailyAllowed": 9828,
"messageId": null,
"message": null,
"data": {
"parentAsin": "B077HN95T8",
"itemName": "Pendleton Women’s Heritage Chelsea Slip-Resistant Rain Boot",
"salesRank": 31070,
"options": [
"Size",
"Color"
],
"totalVariations": 86,
"variants": [
{
"asin": "B0772WW76G",
"productUrl": "https://www.amazon.com/dp/B0772WW76G?th=1&psc=1",
"option1": "Size",
"option1Value": "6",
"option2": "Color",
"option2Value": "Rainier Red",
"BBSellerName": "Fishbone Apparel",
"BBPrice": 109.95,
"BBQuantity": 2,
"BBType": "FBA",
"salesRank": 31070,
"totalOffers": 1,
"dimension": "3.8 x 9.5 x 11.7 inches",
"imageUrl": "https://m.media-amazon.com/images/I/31wd4kuv6IL._SCLZZZZZZZ__SL80_.jpg",
"weight": "3.351 pounds",
"reviewPercentage": 2.08,
"reviewCount": 2,
"globalRatingsPositive": 4486,
"globalRatingsCritical": 421,
"globalReviewPositive": 1286,
"globalReviewCritical": 271,
"recentReview": "March 7, 2020",
"searchStatus": "completed"
},
{
"asin": "B07PJT8S6K",
"productUrl": "https://www.amazon.com/dp/B07PJT8S6K?th=1&psc=1",
"option1": "Size",
"option1Value": "6",
"option2": "Color",
"option2Value": "Starwatchers Blue Print",
"BBSellerName": "new pairs",
"BBPrice": 109.95,
"BBQuantity": 2,
"BBType": "FBA",
"salesRank": 31070,
"totalOffers": 1,
"dimension": "4.25 x 10.87 x 13.07 inches",
"imageUrl": "https://m.media-amazon.com/images/I/41ooAxDOy5L._SCLZZZZZZZ__SL80_.jpg",
"weight": "3.4502 pounds",
"reviewPercentage": 0,
"reviewCount": 0,
"globalRatingsPositive": 0,
"globalRatingsCritical": 0,
"globalReviewPositive": 0,
"globalReviewCritical": 0,
"recentReview": "",
"searchStatus": "completed"
}
]
},
"rid": "5e70778ce4b09ae7cdd98243",
"dateProcessed": 1584429103564,
"domain": "www.amazon.com",
"totalCreditsDeducted": 1
}製品バリエーション クエリ コールバック レスポンス JSON 属性
| 属性名 | 詳細 |
|---|---|
| status | リクエストのステータス。 |
| 応答のための | 製品バリエーションのクエリ結果の「productvariations」値 |
| 許可されて | 現在許可されているリクエスト数。 毎月リセットされます。 |
| 毎日許可 | 現在許可されている XNUMX 日あたりのリクエスト数。 毎日リセットされます。 |
| メッセージID | メッセージの ID (存在する場合)。 |
| メッセージ | 実際のメッセージ (存在する場合)。 参照してください エラーメッセージ. |
| 取り除く | リクエストID。 これを使用して、この応答を元の要求と照合することができます。 |
| 処理された日付 | リクエストが処理された日付 (Unix 時間形式)。 |
| ドメイン | ターゲットの Amazon ドメイン。 |
| 差し引かれる合計クレジット数 | このフィールドは、このリクエストを満たすために使用された Amzpecty API クレジットの数を示します。 |
| data.parentAsin | 商品バリエーションの親 ASIN。 |
| データ。 項目名 | 商品の項目名です。 |
| データ。 売上ランク | 親商品の売上ランク。 |
| データ。 オプション[] | 利用可能なオプションのリスト。 例 [「サイズ」、「カラー」] |
| データ.トータルバリエーション | 親 Asin のバリエーションの総数。 |
| データ。 バリエーション[] | 親 Asin のバリアントのリスト。 |
| data.variants[n].asin | この亜種のアシン。 |
| data.variants[n].productUrl | このバリアントの製品 URL。 |
| data.variants[n].option1 | data.options[] にリストされているこの最初のオプションのキー。 例：「サイズ」 |
| data.variants[n].option1Value | この最初のオプションの値。 例：「9」 |
| data.variants[n].option2 | data.options[] にリストされているこの XNUMX 番目のオプションのキー。 例：「色」 |
| data.variants[n].option2Value | この XNUMX 番目のオプションの値。 例：「イエローストーンイエロー」 |
| data.variants[n].option* | data.options[] にリストされているこの n 番目のオプションのキー。 |
| data.variants[n].option*Value | この n 番目のオプションの値。 |
| data.variants[n].BBSellerName | このバリアントの Buybox 販売者名。 |
| data.variants[n].BBPrice | 送料を除いたこのバリアントの購入箱価格。 |
| data.variants[n].BBQuantity | このバリアントの Buybox 販売者が利用できる数量。 |
| data.variants[n].BBType | このバリアントの販売者のタイプ。 「FBA」または「FBM」 |
| data.variants[n].salesRank | このバリエーションの売上ランキング。 |
| data.variants[n].totalOffers | このバリアントのオファーの数。 |
| data.variants[n].dimension | このバリアントの次元。 |
| data.variants[n].imageUrl | このバリアントの画像 URL。 |
| data.variants[n].weight | このバリアントの重量。 |
| data.variants[n].reviewPercentage | このバリアントの (レビュー数 / すべてのレビュー数) X 100 。 |
| 11 年 2020 月 XNUMX 日時点で非推奨です。代わりに globalReviewPositive と globalReviewCritical を使用してください。 | |
| data.variants[n].globalRatingsPositive | 新しい。 11 年 2020 月 XNUMX 日追加。このバリアントの全世界の肯定的な評価の合計数。 |
| data.variants[n].globalRatingsCritical | 新しい。 11 年 2020 月 XNUMX 日追加。このバリアントのグローバル クリティカル評価の合計数。 |
| data.variants[n].globalReviewPositive | 新しい。 11 年 2020 月 XNUMX 日追加。このバリアントの全世界の肯定的なレビューの合計数。 |
| data.variants[n].globalReviewCritical | 新しい。 11 年 2020 月 XNUMX 日追加。この亜種の全世界の批判的レビューの合計数。 |
| data.variants[n].recentReview | このバリアントの最新のレビュー日。 |
| data.variants[n].searchStatus | このバリアントのクエリ ステータス。 「進行中」または「完了」 |
製品バリエーションの取得 親 ASIN によるクエリ結果データの取得
Get 呼び出しに対する 0 (ゼロ) クレジット控除。
親 ASIN ごとに製品バリエーションのクエリ結果データを取得するリクエスト。
要求
| URI | /api/query/getmatchasins/rid/{rid}?domain={ドメイン}&secretKey={secretKey} | { PARENTASIN } – 最新のバリアント リストを取得するための親 ASIN {domain} – オプション – 指定しない場合、デフォルトは www.amazon.com です。 見る サポートされている Amazon ドメイン リスト用。 |
| 例 | /api/query/getvariants/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
応答
見る 製品バリエーション クエリコールバック JSONサンプルデータ
リクエストIDによる製品バリエーションのリクエスト結果データの取得
リクエストIDによる商品バリエーションのクエリ結果データを取得するリクエストです。
クレジット控除
Get 呼び出しに対する 0 (ゼロ) クレジット控除。
要求
| URI | /api/query/getvariants/rid/{ RID }?domain={ドメイン}&secretKey={secretKey} | { RID } – 最新のバリアント リストを取得するためのリクエスト ID {domain} – オプション – 指定しない場合、デフォルトは www.amazon.com です。 見る サポートされている Amazon ドメイン リスト用。 |
| 例 | /api/query/getvariants/rid/ 5e712345e4b04dd8c8b7e490?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
