Catalog Items v2022-04-01 updated to include additional attributes
In early 2024 Amazon added six new fields to the Catalog Items v2022-04-01 endpoint, including itemContributor, itemContributorRole, itemManufacturer, itemPackageQuantity, itemReleaseDate and its precision sub‑fields. The enriched JSON payload now mirrors the legacy MWS feed, giving sellers exact manufacturer names and release‑date granularity (e.g., "2023-09-15" with precision "day").
Overview
In early 2024 Amazon refreshed the Catalog Items v2022‑04‑01 endpoint, injecting a range of previously unavailable attributes into the item summary payload. The change brings the REST‑based catalog service into line with the older MWS Catalog Items feed, giving sellers richer product metadata for each ASIN. Any automation that pulls catalog data now needs to be updated to capture the new fields, or risk missing critical information such as manufacturer details or precise release dates.
Key Points
- Contributor identification — New fields
itemContributoranditemContributorRoledisclose who is responsible for the product (for example, “Amazon | Brand”). - Manufacturer visibility — The
itemManufacturerattribute surfaces the original maker, enabling more accurate brand‑level reporting. - Package count —
itemPackageQuantitytells how many units are shipped together, such as “2 packs” for a multi‑pack supplement. - Release‑date granularity — A trio of attributes (
itemReleaseDate,itemReleaseDatePrecision,itemReleaseDateDescription) conveys the official launch date and how precise that date is (day, month, or year). - Original market entry —
itemReleaseDateOriginaltogether with its precision sub‑fields records when the product first appeared on the market, useful for vintage or collectible listings. - MWS parity — Adding these fields aligns the REST API with the legacy MWS Catalog Items service, simplifying data handling for sellers that operate across both interfaces.
How the Updated Catalog Items API Works
-
Issue the GET request — A seller calls the endpoint
https://sellingpartnerapi-na.amazon.com/catalog/v2022-04-01/itemsand includes one or more ASINs in theidentifiersquery string.
Example:GET …/items?identifiers=ASIN:B07FZ8S74R,ASIN:B08N5WRWNWreturns summary information for two distinct products.
Analysis & Recommendations
Why This Matters
Missing the new attributes will cause gaps in brand reporting, inventory bundling, and launch‑date analytics, especially for products like the Echo Dot where the release date is now provided as 2023-09-15. Aligning REST responses with MWS ensures consistent data across both APIs, preventing duplicate mapping work.
Key Takeaways
- New fields itemContributor and itemContributorRole expose who is responsible for the product (e.g., "Amazon | Brand").
- itemManufacturer now returns the original maker, such as "Amazon Technologies Inc.", enabling accurate brand KPIs.
- itemPackageQuantity indicates units per pack (e.g., 2 for a 2‑Pack supplement).
- Release‑date trio (itemReleaseDate, itemReleaseDatePrecision, itemReleaseDateDescription) provides exact launch dates like "2023-09-15" with day pr...
Recommended Actions
- →Update your catalog ingestion script to map itemManufacturer to the Manufacturer column in your DB (Seller Central > Reports > Inventory).
- →Add columns for contributor, contributor_role, package_qty, release_date and release_precision in your product table and populate them from the API...
- →Test the revised GET request in the SP‑API sandbox (https://sandbox.sellingpartnerapi-na.amazon.com/catalog/v2022-04-01/items) and verify all new f...
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!