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 字符

示例

{
    "requests": [
        {
            "asin": "string",
            "marketplaceId": "string",
            "includedData": [
                "featuredBuyingOptions"
            ],
            "lowestPricedOffersInputs": [
                {
                    "itemCondition": "New",
                    "offerType": "CONSUMER"
                }
            ],
            "method": "GET",
            "uri": "string"
        }
    ]
}

示例代码

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服务器故障