productPricing_getFeaturedOfferExpectedPriceBatch

Featured offer expected price (FOEP) for 1–20 seller SKUs (Product Pricing v2022-05-01) — the price at or below which each SKU is expected to win the featured offer, an input for r

readAmazon Seller (SP-API)sp.productPricing_2022-05-01

epricing (listings_patchListingsItem), not a guarantee. The server fills the batch uri, method and marketplaceId — pass only sku (and an optional segment) per request. Amazon SP-API · getFeaturedOfferExpectedPriceBatch · POST /batches/products/pricing/2022-05-01/offer/featuredOfferExpectedPrice

Call it

In an AI client (MCP)

tools/call
{
  "name": "productPricing_getFeaturedOfferExpectedPriceBatch",
  "arguments": {
    "store": "myStore-US",
    "requests_": []
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/productPricing_getFeaturedOfferExpectedPriceBatch \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","requests_":[]}'
Early access — the Tool API is open on request, contact us.

Arguments

NameTypeDescription
storerequiredstringthe store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim.
requests_requiredobject[]1–20 of {sku (required), marketplaceId (optional; defaults to the store's), segment (optional location scope: {segmentDetails: {sampleLocation: {postalCode: {countryCode, value}}}})}, e.g. [{"sku": "MY-SKU-001"}].

Result

Every tool answers {notification, data, human_action}; data carries:

  • data.ok — the SKUs Amazon accepted (statusCode 200, no errors).
  • data.failed — [{identifier, status, reason}] for transport failures — statusCode not 200 (a bogus SKU lands here: 400 with body.errors code InvalidInput), a body.errors list, or no response envelope (status 'NoResponse'); notification.type is 'warning' whenever it is non-empty.
  • data.result_statuses — [{sku, resultStatus, has_price}], one per featuredOfferExpectedPriceResults entry. featuredOfferExpectedPrice is present ONLY when resultStatus is VALID_FOEP. NO_COMPETING_OFFER is a legitimate success with no price — you hold the featured offer unopposed, and currentFeaturedOffer shows at what price; the other statuses are OFFER_NOT_ELIGIBLE, OFFER_NOT_FOUND and ASIN_NOT_ELIGIBLE. Never read a blank price as "no repricing needed" — this list says WHY there is none.
  • data.responses — per SKU — {request: {marketplaceId, sku, segment} (echoed, to map a response to its SKU), status: {statusCode, reasonPhrase}, body: {offerIdentifier: {marketplaceId, sku, asin}, featuredOfferExpectedPriceResults: [{resultStatus,
  • data.responses.featuredOfferExpectedPrice — {listingPrice: {amount, currencyCode}}, currentFeaturedOffer, competingFeaturedOffer}], errors}}.

Body (Amazon schema): {requests: [FeaturedOfferExpectedPriceRequest]} (min 1), each item

uri*: string
method*: GET | PUT | PATCH | DELETE | POST
body: object
headers: object
marketplaceId*: string
sku*: string
segment: {segmentDetails: {glanceViewWeightPercentage, sampleLocation}}

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude