Create and Manage Catalogs
Buy with Prime API is now available for early access
Sign up for early access to the Buy with Prime API using the 'Sign Up' button below. The API may change as Amazon receives feedback and iterates on it.
Before you can offer Buy with Prime, you must populate a Buy with Prime catalog with products. You can upload products to your catalog in two ways:
- To use a catalog feed, you upload a CSV file that contains your product information, which supports up to 15,000 products per upload. For details, see Upload a Catalog.
- You can upload products one by one. For details, see Create and Manage Products in a Catalog.
You can also create new products, update existing products, or delete products from the catalog. For details, see Create and Manage Products in a Catalog. After you create products, you can query and retrieve information associated with those products. For details, see Query a Catalog.
API operations
You use the following mutations, queries, and events to create and manage catalogs.
Mutations
| Name | Description |
|---|---|
createCatalogFeed | Creates a catalog feed, which represents a bulk data import operation of Buy with Prime products. |
createUploadLink | Gets a temporary upload URL for uploading a catalog feed file. After the file is uploaded, you can pass the returned fileId to other Buy with Prime API operations to further process the uploaded file. |
createProduct | Create a new product within your Buy With Prime catalog. |
updateProduct | Update an existing product in your Buy With Prime catalog. |
deleteProduct | Delete an existing product from your Buy With Prime catalog. |
Queries
| Name | Description |
|---|---|
catalogFeed | Gets a catalog feed, which represents a bulk data import operation of Buy with Prime products. |
downloadLink | Gets a temporary URL that you use to download files using file IDs returned by Buy with Prime operations such as the catalogFeed query. |
inventoryItem | Gets an inventory item by using a Buy With Prime inventory identifier. |
product | Returns a product, which holds the product identifier mapping between an e-commerce platform and Amazon's fulfillment systems. |
products | Returns a ProductConnection, which holds a list of edges that contain a product. For details about edges, see Pagination in the GraphQL documentation. |
Events
| Event | When Event is Published |
|---|---|
BUYABILITY_CHANGED | An item that was previously eligible for Buy with Prime is no longer eligible for Buy with Prime, or vice versa. |
INVENTORY_CHANGED | An item's inventory level changes or an item has an error that requires merchant action. |
Related topics
Updated 6 days ago