Get competitive summary for ASINs - Seller Assistant API

Retrieve competitive summary for up to 20 ASINs in a single batch request. ASIN and MarketplaceId are required. ItemCondition may be New or Used. The limit is 60 requests per minute. Amazon seller account integration is required to make this request. You can do it here.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

api_key: ********************

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Body Params application/jsonRequired

Example

{
    "requests": [
        {
            "asin": "B00ZIAODGE",
            "marketplaceId": "ATVPDKIKX0DER",
            "includedData": [
                "featuredBuyingOptions",
                "referencePrices",
                "lowestPricedOffers"
            ],
            "lowestPricedOffersInputs": [
                {
                    "itemCondition": "New",
                    "offerType": "Consumer"
                }
            ],
            "method": "GET",
            "uri": "/products/pricing/2022-05-01/items/competitiveSummary"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Successful response

Bodyapplication/json

Example

{
    "responses": [
        {
            "status": {
                "statusCode": 200,
                "reasonPhrase": "Success"
            },
            "body": {
                "asin": "B00ZIAODGE",
                "marketplaceId": "ATVPDKIKX0DER",
                "featuredBuyingOptions": [
                    {
                        "buyingOptionType": "New",
                        "segmentedFeaturedOffers": [
                            {
                                "sellerId": "A2R2RITDJNW1Q6",
                                "condition": "New",
                                "fulfillmentType": "AFN",
                                "listingPrice": {
                                    "currencyCode": "USD",
                                    "amount": 11.88
                                },
                                "featuredOfferSegments": [
                                    {
                                        "customerMembership": "PRIME",
                                        "segmentDetails": {
                                            "glanceViewWeightPercentage": 33.33,
                                            "sampleLocation": {
                                                "postalCode": {
                                                    "countryCode": "US",
                                                    "value": "23221"
                                                }
                                            }
                                        }
                                    }
                                ],
                                "subCondition": "string",
                                "shippingOptions": [
                                    {
                                        "shippingOptionType": "DEFAULT",
                                        "price": {
                                            "currencyCode": "USD",
                                            "amount": 0
                                        }
                                    }
                                ],
                                "points": "string",
                                "primeDetails": "string"
                            }
                        ]
                    }
                ],
                "lowestPricedOffers": [
                    {
                        "lowestPricedOffersInput": {
                            "itemCondition": "New",
                            "offerType": "Consumer"
                        },
                        "offers": [
                            {
                                "sellerId": "A2R2RITDJNW1Q6",
                                "condition": "New",
                                "fulfillmentType": "AFN",
                                "listingPrice": {
                                    "currencyCode": "USD",
                                    "amount": 11.88
                                },
                                "subCondition": "New",
                                "shippingOptions": [
                                    {
                                        "shippingOptionType": "DEFAULT",
                                        "price": {
                                            "currencyCode": "USD",
                                            "amount": 0
                                        }
                                    }
                                ],
                                "points": "string",
                                "primeDetails": {
                                    "eligibility": "NATIONAL"
                                }
                            }
                        ]
                    }
                ],
                "referencePrices": [
                    {
                        "name": "CompetitivePrice",
                        "price": {
                            "currencyCode": "USD",
                            "amount": 13.98
                        }
                    }
                ],
                "errors": [
                    {
                        "code": "INVALID_REQUEST",
                        "message": "Invalid ASIN format",
                        "details": [
                            "string"
                        ]
                    }
                ]
            }
        }
    ]
}

🟠402PaymentRequired

🟠403AccessDenied

🟠422BusinessLogicError

🟠429TooManyRequests

🔴500InternalError