Retrieve a list of featured offers for a batch of up to 20 ASINs
Learn how to retrieve information about the featured offers by ASIN (up to 20 ASINs) using a batch operation.
Learn how to retrieve information about the featured offers by ASIN (up to 20 ASINs) using a batch operation.
Prerequisites
To complete this tutorial, you must have:
- Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API applications.
- The Pricing and Product Listing roles assigned to your developer profile.
- The Pricing and Product Listing roles selected in the app registration page for your application.
Get the competitive summary
The getCompetitiveSummary operation retrieves detailed pricing and offer information for specific products within an Amazon store. It returns data on featured buying options, reference prices, and the lowest-priced offers available, which include information such as the seller, item condition, listing price, and shipping costs. The response helps you compare various offers and pricing options, including segmented details based on customer type. The getCompetitiveSummary includes sampleLocation in its response. This optional sampleLocationresponse is currently available in US, CA, MX, BR, DE, UK, IT, FR, ES, IN, JP, AU, SG Amazon stores.
ReferencePrices
ReferencePricesThe following reference prices might be returned in the referencePrices section of the API:
| Name | Description |
|---|---|
CompetitivePriceThreshold | Price based on competitive prices from other retailers (excluding other Amazon sellers). The offer may be ineligible for the Buy Box if the seller's price + shipping (minus Amazon Points) is greater than this competitive price. This reference price is available only in the JP Amazon store. |
CompetitivePrice | The Competitive Price is the lowest price for an item, or items that customers may consider to be equivalent, recently found at another reputable retailer outside of the Amazon store, which may be used in determining Featured Offer eligibility. This reference price is available in all Amazon stores except JP. |
WasPrice | This price is determined using the 90-day median price paid by customers for the product on Amazon. We exclude prices paid by customers for the product during limited time promotions. For Amazon Fresh offers, the Typical Price is calculated as the median price offered locally in the last 35 days, excluding prices on promotions. |
Promotions
PromotionsThe promotions array returns active promotion details for each offer in the getCompetitiveSummary response. The getCompetitiveSummary response includes this data in both featuredBuyingOptions and lowestPricedOffers sections. The response might not include all active promotions for an offer.
The response includes the following promotion types:
| Promotion type | Description |
|---|---|
COUPON | A coupon that customers clip and apply at checkout. |
DEAL | A time-limited deal (for example, Lightning Deal or Best Deal) that automatically applies a discount at purchase. |
BASKET_BUILDING | A multi-quantity promotion where customers purchase multiple qualifying items to receive a discount. Includes promotions created in Seller Central under Advertising > Manage Promotions. |
Each promotion object contains:
| Field | Required | Description |
|---|---|---|
promotionType | Yes | The type of promotion (COUPON, DEAL, or BASKET_BUILDING). |
promotionSavings | Yes | The savings applied by the promotion. |
purchaseRequirements | No | Purchase requirements for BASKET_BUILDING promotions. Defines what customers must buy to qualify. |
The promotionSavings object contains:
| Field | Description |
|---|---|
discount | The promotion discount. Contains a type field (PERCENTAGE_OFF or AMOUNT_OFF), and either percentOff (a number from 1-100) or amountOff (a monetary value). |
discountedPrice | The final price after the promotion is applied. |
For BASKET_BUILDING promotions, the purchaseRequirements object specifies conditions the customer must meet. It contains a condition with either:
quantityThreshold: The minimum quantity of items the customer must purchase. Containstype(AT_LEASTorFOR_EACH) andquantity.amountThreshold: The minimum amount the customer must spend. Containstype(AT_LEAST) andcurrency(a monetary value).
Updated 9 days ago