Listings migration FAQ
Questions about migrating listings management workflows to Listings Items API and JSON-based feeds.
Am I required to migrate off the feed types listed in this guide?
Yes. We are deprecating XML and flat file listings data (including pricing, inventory, relationships, and images) submitted with the Feeds API and will no longer provide new features or categories in the legacy category XML format.
If you have an application that uses XML or flat file listings data, you have until March 31, 2025 to migrate to the JSON-based Listings Items APIs or the JSON_LISTINGS_FEED
submitted with the Feeds API. This deprecation does not impact any listings feeds submitted by sellers directly through Seller Central.
The JSON-based Listings API and JSON_LISTINGS_FEED
feed type enable you to access new listings capabilities and are available for all product types in hardlines, softlines, and consumables categories worldwide. With these offerings, you can build comprehensive, efficient, and event-driven listings workflows.
However, not all Shipping overrides (POST_PRODUCT_OVERRIDES_DATA
) are deprecated. Sellers using shipping overrides should migrate to account-level or shipping template settings as soon as possible to avoid disruption. The MerchantShippingGroupName
attribute can be used with the existing POST_PRODUCT_DATA
feed type for shipping templates until migration to the Listings Items API or JSON_LISTINGS_FEED
is complete.
Can I continue to use existing feed types until my migration is complete?
Yes. You can continue to use your existing listings workflows while migrating. When migrated (in whole or in part), submissions for the same content should not be duplicated using both workflows. For example, if you have migrated a workflow for price-only updates, submitting the same price-only updates in both old and new workflows will be redundant and cause processing delays for the duplicate submissions.
Why should I begin migrating now?
Migrating to the Listings API gives you access to up-to-date templates, including clear data requirements for product schemas, and the ability to receive synchronous and asynchronous feedback for your submissions regardless of whether you are a seller or vendor.
Can I continue to submit in bulk with feeds?
Yes. The JSON_LISTINGS_FEED
feed type is compatible and interoperable with the Listings Items API and Product Type Definitions API. Deciding between using the JSON_LISTINGS_FEED
, the Listings Items API, or both depends on your specific use-case. Refer to Creating and Updating Listings Items in Bulk for more details and guidance.
What can I migrate if product types for my use case are not yet available?
The Listings APIs is currently available for the Hardlines and Softlines categories across all marketplaces (except India) worldwide, excluding Consumables, Books, and Media categories. You can still migrate your process of updating just inventory/price or offer updates for any listings item regardless of its product type. Refer to the following table for additional details on your specific use case:
API | Feature Set for un-launched PTs (except IN MP) | Feature set for launched PTs |
---|---|---|
Product Type Definitions API |
|
|
Listings Items API |
|
|
Catalog Items API |
|
|
Notifications API |
Receive event-based triggers for
|
Receive event-based triggers for
|
Restrictions API (for 3P only) |
|
|
Updated about 1 month ago