Update: Product Pricing API v2022-05-01 expands support for getFeaturedOfferExpectedPriceBatch Operation
The Product Pricing API v2022-05-01 now supports the getFeaturedOfferExpectedPriceBatch operation for the Japan marketplace (ID A1VC38T7YXB528). Sellers can include Japanese SKUs in a single batch of up to 100 marketplace‑SKU pairs, with the same response schema as before.
Overview
Amazon has broadened the Product Pricing API (version 2022‑05‑01) to include the Featured Offer Expected Price (FOEP) for the Japan marketplace. The change goes live immediately and allows a single batch request to return FOEP data for every Amazon locale. Sellers who automate pricing should adjust their code to request Japanese data and can now use the expanded insight to fine‑tune offers across all regions.
Key Points
- Japan added to batch endpoint — The batch call now accepts the marketplace identifier for amazon.co.jp, enabling FOEP retrieval for SKUs listed in Japan.
- One request covers all regions — The same API method can pull FOEP for every Amazon marketplace, removing the need for separate calls per country.
- FOEP definition clarified — It represents the highest price at which a seller can still capture the featured‑offer slot before any promotional discounts are applied.
- API version unchanged — The call still uses version v2022‑05‑01, so existing authentication tokens and request structures remain valid.
- Batch limit stays at 100 SKUs — Sellers may continue to submit up to one hundred marketplace‑SKU pairs per request, now with Japanese entries included.
- Response schema unchanged — The JSON layout mirrors earlier releases, ensuring existing parsers can handle the new data without modification.
How the getFeaturedOfferExpectedPriceBatch Operation Works
-
Build the request payload — Assemble a JSON object that lists up to 100 pairs of marketplace IDs and SKUs.
Example:{ "requests": [ { "marketplaceId": "A1VC38T7YXB528", "sku": "JPN-001" }, { "marketplaceId": "A1F83G8C2ARO7P", "sku": "US-099" } ] }where the first identifier corresponds to Japan and the second to the United States. -
Issue the POST call — Send the payload to
https://pricing.amazon.com/paapi/v1/price/getFeaturedOfferExpectedPriceBatchwith the required signed headers (AWS4‑HMAC‑SHA256). : .
Analysis & Recommendations
Why This Matters
Adding Japan to the batch call lets sellers retrieve FOEP for all regions in one request, cutting latency and eliminating separate calls. The 100‑SKU limit remains, so existing batch logic stays valid while opening new competitive pricing opportunities on amazon.co.jp.
Key Takeaways
- Japan marketplace ID A1VC38T7YXB528 is now accepted in getFeaturedOfferExpectedPriceBatch.
- Batch limit stays at 100 marketplace‑SKU pairs, now including Japanese entries.
- FOEP definition clarified as the highest price before promotional discounts.
- Response schema unchanged, so existing parsers need no changes.
Recommended Actions
- →Update your pricing script to add marketplaceId "A1VC38T7YXB528" to the request payload for Japan (e.g., in Seller Central > Developer Tools > Pric...
- →Run a test batch including Japanese SKUs via the POST endpoint https://pricing.amazon.com/paapi/v1/price/getFeaturedOfferExpectedPriceBatch and ver...
- →Implement error handling for JP errors (InvalidSKU, MarketplaceNotSupported) in your code and log them for review.
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!