getCompetitiveSummary - Amazon Selling Partner API (SP-API)-中文

返回包含所选ASIN和marketplaceId组合的竞争摘要响应，包括特色购买选项。

使用计划：

速率（每秒请求数）	突发
0.033	1

x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划速率限制（如果有）。上表显示了此操作的默认速率和突发值。业务需求需要更高吞吐量的销售合作伙伴可能会看到比这里显示的更高的速率和突发值。有关更多信息，请参阅销售合作伙伴API中的使用计划和速率限制。

请求参数

Body 参数application/json

`competitiveSummary` 批量请求数据。

requests

array[object (CompetitiveSummaryRequest) {6}]

必需

一批 competitiveSummary 请求的列表。

>= 1 items<= 20 items

asin

string

必需

该商品的亚马逊标准识别号码（ASIN）。

marketplaceId

string

必需

市场标识符。指定返回数据的市场。

includedData

array[string]

必需

产品的竞争价格数据请求清单。

>= 1 items

枚举值:

featuredBuyingOptionsreferencePriceslowestPricedOffers

lowestPricedOffersInputs

array[object (LowestPricedOffersInput) {2}]

可选

lowestPricedOffersInput 参数的列表，用于构建响应中的 lowestPricedOffers。该属性仅在 includedData 中请求 lowestPricedOffers 时有效。

>= 0 items<= 5 items

method

enum<string>

必需

与批处理中的单个请求相关联的HTTP方法。

枚举值:

GETPUTPATCHDELETEPOST

uri

string

必需

与批量请求中被调用的各个 API 相关联的 URI。

>= 6 字符<= 512 字符

示例

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`competitiveSummaryBatch` 操作的响应模式。

responses

array[object (CompetitiveSummaryResponse) {2}]

必需

competitiveSummaryBatch 操作的响应列表。

>= 1 items<= 20 items

status

object (HttpStatusLine)

必需

与批量中单个请求的响应相关联的HTTP状态行。有关更多信息，请参见RFC 2616。

body

object (CompetitiveSummaryResponseBody)

必需

请求的ASIN和marketplaceId的competitiveSummaryResponse主体。

示例

{
  "responses": [
    {
      "status": {
        "statusCode": 200,
        "reasonPhrase": "Success"
      },
      "body": {
        "asin": "B00ZIAODGE",
        "marketplaceId": "ATVPDKIKX0DER",
        "featuredBuyingOptions": [
          {
            "buyingOptionType": "New",
            "segmentedFeaturedOffers": [
              {
                "sellerId": "A3DJR8M9Y3OUPG",
                "condition": "New",
                "fulfillmentType": "MFN",
                "listingPrice": {
                  "amount": 18.11,
                  "currencyCode": "USD"
                },
                "shippingOptions": [
                  {
                    "shippingOptionType": "DEFAULT",
                    "price": {
                      "amount": 2.5,
                      "currencyCode": "USD"
                    }
                  }
                ],
                "points": {
                  "pointsNumber": 3,
                  "pointsMonetaryValue": {
                    "amount": 0.03,
                    "currencyCode": "USD"
                  }
                },
                "featuredOfferSegments": [
                  {
                    "customerMembership": "PRIME",
                    "segmentDetails": {
                      "glanceViewWeightPercentage": 72
                    }
                  },
                  {
                    "customerMembership": "NON_PRIME",
                    "segmentDetails": {
                      "glanceViewWeightPercentage": 18
                    }
                  }
                ]
              },
              {
                "sellerId": "A2ZWOLFOFDPJL1",
                "condition": "New",
                "fulfillmentType": "MFN",
                "listingPrice": {
                  "amount": 17.15,
                  "currencyCode": "USD"
                },
                "shippingOptions": [
                  {
                    "shippingOptionType": "DEFAULT",
                    "price": {
                      "amount": 2.5,
                      "currencyCode": "USD"
                    }
                  }
                ],
                "points": {
                  "pointsNumber": 3,
                  "pointsMonetaryValue": {
                    "amount": 0.03,
                    "currencyCode": "USD"
                  }
                },
                "featuredOfferSegments": [
                  {
                    "customerMembership": "NON_PRIME",
                    "segmentDetails": {
                      "glanceViewWeightPercentage": 10
                    }
                  }
                ]
              }
            ]
          }
        ],
        "referencePrices": [
          {
            "name": "CompetitivePriceThreshold",
            "price": {
              "amount": 18.11,
              "currencyCode": "USD"
            }
          }
        ],
        "lowestPricedOffers": [
          {
            "lowestPricedOffersInput": {
              "itemCondition": "New",
              "offerType": "Consumer"
            },
            "offers": [
              {
                "listingPrice": {
                  "currencyCode": "USD",
                  "amount": 17.15
                },
                "shippingOptions": [
                  {
                    "shippingOptionType": "DEFAULT",
                    "price": {
                      "amount": 2.5,
                      "currencyCode": "USD"
                    }
                  }
                ],
                "points": {
                  "pointsMonetaryValue": {
                    "amount": 0.5,
                    "currencyCode": "USD"
                  },
                  "pointsNumber": 50
                },
                "primeDetails": {
                  "eligibility": "REGIONAL"
                },
                "subCondition": "New",
                "sellerId": "A2ZWOLFOFDPJL1",
                "fulfillmentType": "MFN"
              },
              {
                "listingPrice": {
                  "amount": 18.11,
                  "currencyCode": "USD"
                },
                "shippingOptions": [
                  {
                    "shippingOptionType": "DEFAULT",
                    "price": {
                      "amount": 2.5,
                      "currencyCode": "USD"
                    }
                  }
                ],
                "points": {
                  "pointsNumber": 3,
                  "pointsMonetaryValue": {
                    "amount": 0.03,
                    "currencyCode": "USD"
                  }
                },
                "primeDetails": {
                  "eligibility": "NATIONAL"
                },
                "sellerId": "A3DJR8M9Y3OUPG",
                "subCondition": "New",
                "fulfillmentType": "MFN"
              }
            ]
          },
          {
            "lowestPricedOffersInput": {
              "itemCondition": "Used",
              "offerType": "Consumer"
            },
            "offers": [
              {
                "listingPrice": {
                  "CurrencyCode": "USD",
                  "Amount": 12
                },
                "shippingOptions": [
                  {
                    "shippingOptionType": "DEFAULT",
                    "price": {
                      "amount": 2.5,
                      "currencyCode": "USD"
                    }
                  }
                ],
                "primeDetails": {
                  "eligibility": "REGIONAL"
                },
                "subCondition": "Acceptable",
                "sellerId": "A3DH5AGPM3JVAB",
                "fulfillmentType": "AFN"
              }
            ]
          }
        ]
      }
    }
  ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障