The Listings Items API is now available in the JP marketplace
At the start of 2024 Amazon opened the Listings Items API to the Japan marketplace (Amazon.co.jp). Sellers can now use the same 2021-08-01 endpoints—productTypes, items POST/PATCH/GET/DELETE—to create, update, and remove SKUs in a single request, with localized error codes for Japanese regulations.
Overview
Amazon has added support for the Listings Items API in the Japan marketplace at the start of 2024. This expansion lets sellers and developers who operate on Amazon.co.jp manage product listings through the same SP‑API calls used elsewhere. The change is crucial for merchants who rely on automated or bulk listing processes, as it removes the need to enter each SKU manually in Seller Central for the Japanese market.
Key Points
- Marketplace Inclusion — The Listings Items API now accepts calls that target Amazon.co.jp, extending the same functionality previously available only in North America and Europe.
- One‑Shot Product Submission — A single request can carry the full set of attributes, images, and compliance data required for a new SKU, cutting the number of round‑trips needed to launch a product.
- Product‑Type Catalog — An endpoint returns a searchable list of every product type currently supported on the Japanese site, helping sellers pick the correct taxonomy before they submit data.
- Instant Inventory Updates — Price, quantity, or condition changes sent via the API appear on the JP storefront within minutes, dramatically lowering the chance of overselling.
- Localized Error Feedback — The service provides error codes that reflect Japanese regulatory rules, such as restrictions on certain ingredients or labeling requirements, enabling faster correction.
How Listings Items API Works
- Fetch JP‑Approved Product Types — Send a GET request to
/listings/2021-08-01/productTypes. The response contains a JSON array of identifiers that are valid on Amazon.co.jp. Example: A tea exporter queries the list, finds the identifier “FoodAndBeverage”, and notes that the attribute “originCountry” is mandatory for that type. - Create a New SKU — Issue a POST to
/listings/2021-08-01/items/{sellerId}/{sku}with a payload that includes the chosen product‑type ID, title, description, image URLs, price, and stock quantity. Example: The seller posts a payload for SKU “JPN‑TEA‑001” priced at ¥2,500, stocked with ten units, and attaches three high‑resolution images; Amazon returns a 202 Accepted status and a unique listing identifier.
Analysis & Recommendations
Why This Matters
Japanese sellers can replace manual CSV uploads with real‑time API calls, cutting product launch time from days to hours and reducing out‑of‑stock risk. Instant inventory patches appear on the JP storefront within minutes, helping avoid penalties.
Key Takeaways
- Listings Items API is now available for marketplaceId A1VC38T7YXB528 (Amazon.co.jp) as of early 2024.
- A single POST to /listings/2021-08-01/items/{sellerId}/{sku} can submit full attributes, images, and compliance data for a new SKU.
- PATCH requests update price or quantity in ~5 minutes, and DELETE removes a listing within seconds.
- The productTypes endpoint returns a searchable list of JP‑specific product type IDs, such as "FoodAndBeverage" with mandatory "originCountry".
Recommended Actions
- →Call GET https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/productTypes?marketplaceId=A1VC38T7YXB528 to retrieve JP product type IDs.
- →Integrate a POST to /listings/2021-08-01/items/{sellerId}/{sku} in your ERP to create new JP SKUs with full attribute payloads.
- →Set up a nightly PATCH job to /listings/2021-08-01/items/{sellerId}/{sku} to sync price and quantity, verifying responses for Japanese error codes.
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!