📘

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, each Buy with Prime product can be associated 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 value that uniquely identifies your product. For example, if a product's listing is regenerated whenever the details of a product in an internal catalog change, it's better to use the SKU as the ID. If a listing identifier is stable and stays the same throughout the product lifecycle but the SKU can change, the external ID is a better option.

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
• Upload a Catalog
• Get the Result of a Catalog Upload
• Query a Catalog