Product Pricing API v2022-05-01 Use Case Guide

API Version: 2022-05-01

What is the Product Pricing API?

The Product Pricing API is designed to help you develop automated solutions that sellers can use to update and manage their prices. Building in automation for your sellers allows them to react faster to keep their prices competitive and attractive to customers.

⭐

Tip

The Product Pricing API supports the development of repricers. Repricers are automated pricing tools that can continuously monitor price points, competitor prices, and other relevant factors in order to adjust a seller's prices in real-time. Repricers use data and insights from Product Pricing and Notifications APIs to help sellers maintain a competitive price advantage.

Key features

• Retrieve featured offer expected price (FOEP) response data: The getFeaturedOfferExpectedPriceBatch operation retrieves FOEP data for up to 40 SKUs, provided that the items are in new condition, ship nationwide, and are eligible to become the featured offer.
• Retrieve all featured offers for an ASIN: The getCompetitiveSummary API returns every offer that is being featured to Amazon customers, along with the glance view weight percentage for each offer.

To learn more about the terms that are used on this page, refer to Terminology.

Tutorial: Return a batch of FOEP data for a set of SKUs

Learn how to return a set of responses for up to 40 requests for featured offer extended price data.

To help a seller compete for featured offer placement on the product detail page (for items listed in new condition that ship nationwide), use the getFeaturedOfferExpectedPriceBatch. To compete for selection as the featured offer, the seller and their listed items must be eligible.

You can help the seller compete by returning the FOEP for a SKU. Because competing offers can change, featured offer status isn't guaranteed. Different offers can be featured based on other factors, including fulfillment capabilities to a specific customer. The getFeaturedOfferExpectedPriceBatch operation returns batch responses that contain up to 40 FOEP requests. If there are no other competing offers that ship nationwide, Amazon might not return an FOEP value.

❗

Warning

FOEP values are automatically generated, so be sure to carefully verify the calculated values. All sellers using the API are responsible, as the retailer of record for their offers, for setting their prices independently and in compliance with applicable laws and pricing regulations.

The getFeaturedOfferExpectedPriceBatch operation is available in all marketplaces. sampleLocation is the representative location for the segment where the offer is featured.You can use sampleLocation in the request to the getFeaturedOfferExpectedPriceBatch operation to get the Featured Offer Expected Price (FOEP) for a specific location. This feature is currently available in US, CA, MX, BR, DE, UK, IT, FR, ES, IN, JP, AU, SG marketplaces. For more information about Product Pricing API operations, associated data types, and schemas, refer to the Product Pricing v2022-05-01 API Reference.

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 role assigned to your developer profile.
• The Pricing role selected on the app registration page for your application.

Get the FOEP data for a set of SKUs

The getFeaturedOfferExpectedPriceBatch operation is a batch API. The batch request must use an HTTP POST method with a body parameter that contains a list or set of individual requests. The response is a batch response that contains the list of individual HTTP responses, where each response maps to one of the original requested SKUs in the batch.

To return FOEP data, call the getFeaturedOfferExpectedPriceBatch operation.

General recommendations

When to call the getFeaturedOfferExpectedPriceBatch operation

If your seller is subscribed to ANY_OFFER_CHANGED notifications and receives a notification for an ASIN that they want to compete with for the feature offer, you can request FOEP data.

About the resultStatus response property

The resultStatus response property indicates if Amazon returned an FOEP value. This also provides the reason why no FOEP value is returned, when applicable. The possible values are:

Availability of the getFeaturedOfferExpectedPriceBatch operation

This API is available in all marketplaces.

Tutorial: 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.

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 a marketplace. 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 marketplaces.

ReferencePrices

The following reference prices might be returned in the referencePrices section of the API: