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

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

使用计划：

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

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

请求参数

Body 参数application/json

示例

{
    "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

Body

示例

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