The Inventory Mapping API helps sellers create high-quality listings with AI-powered recommendations generated from their existing product data. This API allows sellers and third-party partners to use existing product data to create eBay listing previews, which are then used to create listings through eBay's Listing APIs.

Specifically, the API accepts various input types, including item photos, titles, aspects, and product identifiers, and provides users with an AI-powered listing preview that includes recommendations for category, eBay-normalized item aspects, and description.

This API exposes the data through GraphQL queries and mutations. This allows you to use only those fields needed or available, and provides a process that creates eBay Listing Previews based on the seller's external product information.

How to get started

Try out the Inventory Mapping API using the GraphQL Explorer.

1. Sign in to your developer account and use this explorer to run test calls to this API in the Production environment (Sandbox is not supported).
2. Include the mappingReferenceID field for all listings generated or revised with Inventory Mapping API recommendations to quickly diagnose and resolve issues.
3. Share your feedback on recommendations and use cases to help us improve the product.

* If you need expanded access to support your use cases, you can Apply for an Application Growth Check to scale your integration.

NOTE: The Inventory Mapping API can be integrated with the Notification API to inform sellers when any of their listing preview creation tasks have completed through the LISTING_PREVIEW_CREATION_TASK_STATUS topic ID. If you are not familiar with the Notification API, see the Notification API Overview.

NOTE: The Inventory Mapping API is available for the U.S. marketplace and results should only be used for listings on the U.S. site at this time. We'll notify you as soon as coverage expands to additional marketplaces. Set the marketplace by including the X-EBAY-C-MARKETPLACE-ID header with the value EBAY_US.