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. To add products to your catalog, you can upload a CSV file that contains your product information, which supports up to 15,000 products per upload. For example requests and responses, see:

API operations

You use the following mutations, queries, and events to create and manage catalogs.

Mutations

NameDescription
createCatalogFeedCreates a catalog feed, which represents a bulk data import operation of Buy with Prime products.
createUploadLinkGets 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.

Queries

NameDescription
catalogFeedGets a catalog feed, which represents a bulk data import operation of Buy with Prime products.
downloadLinkGets a temporary URL that you use to download files using file IDs returned by Buy with Prime operations such as the catalogFeed query.
inventoryItemGets an inventory item by using a Buy With Prime inventory identifier.
mappingProductReturns a mapping product, which holds the product identifier mapping between your e-commerce service provider's system and Amazon’s fulfillment systems.

Events

EventWhen Event is Published
BUYABILITY_CHANGEDAn item that was previously eligible for Buy with Prime is no longer eligible for Buy with Prime, or vice versa.
INVENTORY_CHANGEDAn item's inventory level changes or an item has an error that requires merchant action.

Related topics