Amazon Adds Haul Storefront Support to Listings Items API
Amazon added Haul storefront support to the SP‑API Listings Items v2021‑08‑01 endpoint in early 2024, letting approved sellers bulk‑create up to 100 low‑price ($≤20) items per request. The new `haul` object enables programmatic price, inventory, and multi‑offer updates for US‑only Haul listings.
Overview
Amazon has refreshed its Selling Partner API (SP‑API) Listings Items endpoint to let approved sellers create and manage product listings on Amazon Haul through code. The change, rolled out in early 2024, enables bulk uploads, price tweaks, and inventory updates for items priced under $20, eliminating the previous manual entry method. Sellers targeting the budget‑focused Haul storefront should act now to integrate the new parameters and stay competitive.
Key Points
- API version v2021‑08‑01 now includes Haul fields — Sellers can submit Haul‑specific attributes without changing the API version they already use.
- Bulk creation of sub‑$20 listings — A single request can add dozens of low‑price items, streamlining the onboarding of impulse‑buy catalogs.
- Full edit capability — Pricing, stock quantity, and product description can be altered programmatically, supporting rapid repricing strategies.
- Multi‑offer and multi‑fulfillment support — Sellers may attach several offers (e.g., standard and Prime) to the same Haul SKU, each with its own fulfillment method.
- US‑only rollout — The new functionality is limited to Amazon.com; other marketplaces will not accept Haul parameters until a future update.
- Backward compatible — Existing integrations that do not use Haul fields continue to work unchanged, avoiding disruption for current users.
How Listings Items API Handles Haul Listings
- Enable Haul parameters in the request payload — Add the
haulobject to the JSON body of aPOST /listings/2021-08-01/itemscall.- Example:
"haul": { "price": { "amount": "9.99", "currency": "USD" }, "category": "Fashion", "priceCeiling": 20 }
- Example:
- Submit a bulk request — Include an array of up to 100 Haul SKUs in a single API call to create multiple listings at once.
- Example: The payload contains ten different phone accessories, each with its own and block, allowing a single HTTP request to register the entire set.
Analysis & Recommendations
Why This Matters
By automating listings under the $20 price ceiling, sellers can replace manual entry with bulk uploads, cutting onboarding time for dozens of SKUs and enabling real‑time repricing. This speeds inventory turnover on the budget‑focused Haul storefront and helps maintain competitive pricing across multiple offers.
Key Takeaways
- API version v2021‑08‑01 now includes a `haul` object for Haul‑specific attributes without changing the version.
- Bulk creation supports up to 100 SKUs per POST request, streamlining low‑price catalog onboarding.
- Price validation enforces a maximum of $20 and restricts listings to approved Haul categories such as Fashion, Electronics, and Home Goods.
- The feature is limited to the Amazon.com marketplace; other regions will not accept Haul parameters until a future update.
Recommended Actions
- →Enroll in the Haul program: send an email to interested‑[email protected] with your catalog overview.
- →Update your SP‑API app in Seller Central > Developer Settings to include `sellingpartnerapi::listings` and `sellingpartnerapi::notifications` scope...
- →In the SP‑API sandbox, POST a single `haul` item to /listings/2021-08-01/items, confirm the response, then schedule bulk upload scripts.
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!