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 Expected Price (FOEP) data.

The Featured Offer Expected Price (FOEP) is a computed listing price at or below which an offer can expect to become the Featured Offer on a product detail page. If there are no other competing offers that ship nationwide, Amazon might not return an FOEP value.

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 Amazon stores. 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 following Amazon stores: US, CA, MX, BR, DE, UK, IT, FR, ES, IN, JP, AU, SG. 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

Call getFeaturedOfferExpectedPriceBatch in the following scenarios:

• After receiving an ANY_OFFER_CHANGED notification for an ASIN your application manages, based on the OfferChangeTrigger.
• After receiving a PRICING_HEALTH notification indicating a disqualification, to determine the target price needed to regain Featured Offer.
• To retrieve a location-specific FOEP using the sampleLocation parameter (postal code).
• On a periodic basis, to check current FOEP values for managed SKUs.

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: