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

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

使用计划：

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

当可用时，x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划速率限制。上表包含该操作的默认速率和突发值。对于业务需求要求更高吞吐量的销售合作伙伴，可能会获得比此处显示的更高的速率和突发值。有关更多信息，请参考销售合作伙伴API中的使用计划和速率限制。

请求参数

Body 参数application/json必填

示例

{
    "requests": [
        {
            "asin": "string",
            "marketplaceId": "A1PA6795UKMFR9",
            "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

Bodyapplication/json

示例

{
    "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"
                                    }
                                },
                                "promotions": [
                                    {
                                        "promotionType": "COUPON",
                                        "promotionSavings": {
                                            "discount": {
                                                "type": "AMOUNT_OFF",
                                                "amountOff": {
                                                    "amount": 2,
                                                    "currencyCode": "USD"
                                                }
                                            },
                                            "discountedPrice": {
                                                "amount": 16.11,
                                                "currencyCode": "USD"
                                            }
                                        }
                                    },
                                    {
                                        "promotionType": "BASKET_BUILDING",
                                        "promotionSavings": {
                                            "discount": {
                                                "type": "PERCENTAGE_OFF",
                                                "percentOff": 10
                                            }
                                        },
                                        "purchaseRequirements": {
                                            "condition": {
                                                "amountThreshold": {
                                                    "type": "AT_LEAST",
                                                    "currency": {
                                                        "amount": 30,
                                                        "currencyCode": "USD"
                                                    }
                                                }
                                            }
                                        }
                                    }
                                ],
                                "featuredOfferSegments": [
                                    {
                                        "customerMembership": "PRIME",
                                        "segmentDetails": {
                                            "glanceViewWeightPercentage": 72,
                                            "sampleLocation": {
                                                "postalCode": {
                                                    "countryCode": "US",
                                                    "value": "12345"
                                                }
                                            }
                                        }
                                    },
                                    {
                                        "customerMembership": "NON_PRIME",
                                        "segmentDetails": {
                                            "glanceViewWeightPercentage": 10,
                                            "sampleLocation": {
                                                "postalCode": {
                                                    "countryCode": "US",
                                                    "value": "67890"
                                                }
                                            }
                                        }
                                    },
                                    {
                                        "customerMembership": "DEFAULT",
                                        "segmentDetails": {
                                            "glanceViewWeightPercentage": 8,
                                            "sampleLocation": {
                                                "postalCode": {
                                                    "countryCode": "US",
                                                    "value": "98101"
                                                }
                                            }
                                        }
                                    }
                                ]
                            },
                            {
                                "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"
                                    }
                                },
                                "promotions": [
                                    {
                                        "promotionType": "DEAL",
                                        "promotionSavings": {
                                            "discountedPrice": {
                                                "amount": 17.15,
                                                "currencyCode": "USD"
                                            }
                                        }
                                    }
                                ],
                                "featuredOfferSegments": [
                                    {
                                        "customerMembership": "NON_PRIME",
                                        "segmentDetails": {
                                            "glanceViewWeightPercentage": 10,
                                            "sampleLocation": {
                                                "postalCode": {
                                                    "countryCode": "US",
                                                    "value": "12345"
                                                }
                                            }
                                        }
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "referencePrices": [
                    {
                        "name": "CompetitivePriceThreshold",
                        "price": {
                            "amount": 18.11,
                            "currencyCode": "USD"
                        }
                    },
                    {
                        "name": "CompetitivePrice",
                        "price": {
                            "amount": 17.39,
                            "currencyCode": "USD"
                        }
                    },
                    {
                        "name": "WasPrice",
                        "price": {
                            "amount": 18.49,
                            "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",
                                "promotions": [
                                    {
                                        "promotionType": "COUPON",
                                        "promotionSavings": {
                                            "discount": {
                                                "type": "PERCENTAGE_OFF",
                                                "percentOff": 10
                                            },
                                            "discountedPrice": {
                                                "amount": 16.29,
                                                "currencyCode": "USD"
                                            }
                                        }
                                    }
                                ]
                            },
                            {
                                "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",
                                "promotions": [
                                    {
                                        "promotionType": "BASKET_BUILDING",
                                        "promotionSavings": {
                                            "discount": {
                                                "type": "AMOUNT_OFF",
                                                "amountOff": {
                                                    "amount": 3,
                                                    "currencyCode": "USD"
                                                }
                                            }
                                        },
                                        "purchaseRequirements": {
                                            "condition": {
                                                "quantityThreshold": {
                                                    "type": "AT_LEAST",
                                                    "quantity": 1
                                                }
                                            }
                                        }
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "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",
                                "promotions": [
                                    {
                                        "promotionType": "DEAL",
                                        "promotionSavings": {
                                            "discountedPrice": {
                                                "amount": 10,
                                                "currencyCode": "USD"
                                            }
                                        }
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "similarItems": [
                    {
                        "items": [
                            {
                                "asin": "B00ZIA513F"
                            },
                            {
                                "asin": "B009DA8GI1"
                            },
                            {
                                "asin": "B00KF8SK3D"
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障