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)
{
"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
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
requests_required | object[] | 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}}