📘

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.

Sign Up

This topic provides best practices when you Create and Manage Catalogs.

Which product identifier to use

When you Create and Manage Catalogs, you can associate each product with multiple product identifiers. Although you can use any of these values to identify a product when you call the Buy with Prime API, we recommend that use your own identifiers, such as the following IDs:

• External product ID that you provide, such as a listing ID
• SKU assigned by your service

For example, when you render a product detail page, you likely already have a listing ID (external product ID) in the context.

Make sure that you use a stable, immutable identifier that is unique for each product in a catalog. For example, if the product's listing is regenerated when the details in an internal catalog change, use the SKU as the ID. If a listing identifier stays the same throughout the product lifecycle but the SKU can change, use the external ID.

Calculating inventory for product detail pages and checkout

The available number of products is a point in time calculation, with potential delays. To determine whether a shopper can order an item through Buy with Prime, we recommend that you determine inventory based on whether a call to the Delivery Preview interface succeeds. If you encounter an ItemAmountUnavailable error, the requested quantity isn't available. For example requests and responses, see Create a Delivery Preview for a Product Detail Page and Create a Delivery Preview for Checkout.

Related topics

• Create and Manage Catalogs
• Create and Manage Products in a Catalog
• Upload a Catalog
• Get the Result of a Catalog Upload
• Query a Catalog