Competing for Featured Offer Using Expected Price (FOEP) π·οΈπ°π― #522
MeenaAmz
started this conversation in
Pricing, Fees & Promotions
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Building a repricing solution means responding to market changes, and knowing the expected price can unlock a competitive advantage. Featured Offer Expected Price (FOEP) is a computed listing price at or below which a seller's offer can expect to become the Featured Offer (this is the offer displayed with the "Add to Cart" button on the product detail page).
This guide covers how to integrate
getFeaturedOfferExpectedPriceBatchinto your pricing workflow, when to call it, and how to combine it with notifications for a complete repricing strategy. Use this when you are building or enhancing a repricing solution that targets Featured Offer placement.Authored by: Meena P, Solutions Architect, Selling Partner Developer Services
Pricing signals at a glance
The following pricing signals are available
getFeaturedOfferExpectedPriceBatchANY_OFFER_CHANGEDnotificationPRICING_HEALTHnotificationgetCompetitiveSummaryHow FOEP fits into a repricing workflow
FOEP is a pull-based pricing signal. You call
getFeaturedOfferExpectedPriceBatchon demand, typically triggered by anANY_OFFER_CHANGEDorPRICING_HEALTHnotification, and receive the computed price at or below which an offer can expect to become the Featured Offer.Recommended pattern: Use
ANY_OFFER_CHANGEDorPRICING_HEALTHas a trigger β callgetFeaturedOfferExpectedPriceBatchβ evaluate the response β apply configured pricing rules β submit the price update viapatchListingsItem.Implementation steps
Step 1: Subscribe to notifications
ANY_OFFER_CHANGED
Set up
ANY_OFFER_CHANGEDsubscriptions to get notified when the competitive landscape shifts for an ASIN you sell. Refer to Tutorial: Set up notifications for SQS setup.Understanding OfferChangeTrigger in ANY_OFFER_CHANGED
When you receive an
ANY_OFFER_CHANGEDnotification, theOfferChangeTriggerobject in the payload tells you what changed and why the notification fired. TheOfferChangeTypefield is key for deciding whether to call FOEP:InternalFeatured OfferExternalCompetitivePriceThresholdin the Summary object has changed, triggered by a new offer from a non-Amazon retailer.The
OfferChangeTriggeralso provides:MarketplaceIdβ the marketplace where the change occurredASINβ the item that had the offer change (map this to your seller's SKU before calling FOEP)ItemConditionβ the condition (New, Used, and so on) of the offer that changedTimeOfOfferChangeβ when the change occurred (ISO 8601)Tip: Filter for
OfferChangeTypevaluesInternalandFeatured Offerto reduce unnecessary FOEP calls. These are the events most likely to affect your seller's Featured Offer eligibility.Externalchanges may also warrant a FOEP call if you track competitiveness against non-Amazon retailers.PRICING_HEALTH
PRICING_HEALTHfires when your offer loses Featured Offer eligibility due to an uncompetitive price. Treat this as an urgent signal to call FOEP and reprice immediately. WhileANY_OFFER_CHANGEDhelps you stay ahead,PRICING_HEALTHhelps you recover.Step 2: Call getFeaturedOfferExpectedPriceBatch
Request FOEP for the seller's SKU(s):
Batch up to 40 SKUs per request.
Step 3: Evaluate resultStatus
The response indicates whether Amazon returned an FOEP value:
VALID_FOEPNO_COMPETING_OFFEROFFER_NOT_ELIGIBLEOFFER_NOT_FOUNDASIN_NOT_ELIGIBLEStep 4: Compare FOEP to current price
Check if the current listing price is above the returned FOEP value. If it is, a price adjustment may improve Featured Offer eligibility.
Step 5: Validate before submitting
Call
patchListingsItemwithmode=VALIDATION_PREVIEWto preview any pricing issues before the actual submission.Step 6: Apply pricing rules
Confirm the price change against your configured pricing rules (for example, minimum price thresholds, maximum discount limits). The seller retains final control over pricing decisions.
Step 7: Submit the price update
Call
patchListingsItemto update the offer price. Inspect the response to confirm the submission isACCEPTED. If not, correct validation issues and resubmit.Alternative approaches: Using FOEP without notifications
If your application does not subscribe to
ANY_OFFER_CHANGEDorPRICING_HEALTH, you can still use FOEP effectively with a pull-based approach:Option A: Periodic polling
getFeaturedOfferExpectedPriceBatchon a scheduled cadence (for example, every 15β60 minutes) for your seller's active SKUs.Option B: On new listing creation
Option C: Combined with getCompetitiveSummary
getCompetitiveSummaryon a schedule to monitor the competitive landscape.Best practices
ANY_OFFER_CHANGEDorPRICING_HEALTHtell you when the competitive landscape has shifted or a disqualification occurred, then call FOEP.sampleLocation(postal code) in the request to get regionalized FOEP. UsegetCompetitiveSummaryfirst to identify high-traffic locations via GVWP.getCompetitiveSummaryto retrieve reference prices. This gives you a fuller picture of the competitive landscape so you can validate the FOEP target against external benchmarks and make more informed pricing decisions.patchListingsItemwithmode=VALIDATION_PREVIEWto catch pricing policy violations before the actual submission.Common pitfalls
NO_COMPETING_OFFER), not an error.resultStatusprovides actionable information. Handle all five statuses in your workflow rather than discarding non-VALID_FOEPresponses.Related resources
sampleLocationContent governance
Content Owner: Meena P.
Last Reviewed: August 30, 2026
Next Review Date: February 28, 2027
Feedback
Let us know what you think! π
React or reply below to share your feedback.
β€οΈ Like what you see?
π Excited to try it out?
π Want to see more of this?
Keywords: #FOEP #FeaturedOffer #Pricing #Repricing #AnyOfferChanged #PricingHealth #BuyBox #SPAPINotifications #amazon-sp-api #optimization
Please note the publication date above. While we strive to keep our content current, the rapid evolution of this topic means some details may have changed since publication. For the most up-to-date information, we encourage readers to follow the announcements in SP-API developer documentation.
0 votes ·
All reactions