Update: Product Search API response no longer returns lists of all product categories

Effective February 20, 2026, the Amazon Business Product Search API will no longer return lists of all product categories in the refinements and searchRefinements objects of the searchProductsRequest API operation response. Instead, these objects will display category lists that are relevant to the given search, meaning that some categories previously returned will no longer be displayed. If you need lists of all categories for your integration, see Product Search API categories to obtain static JSON files containing marketplace and locale-specific data.

FAQs

What is changing?
Previously, Product Search API returned a list of all categories in every searchProductsRequest operation response. Now, the response only includes categories relevant to the given search.

Who is impacted?
Any developers who have built functionality in their application based on the categories list previously returned in the refinements and searchRefinements objects, such as navigation bars.

How can I determine if my integration is affected?
If your application requires a categories list in the API response and your implementation doesn’t have a null check, your application’s UI component would break if the categories return null.

What are the steps to migrate?
Use the applicable JSON files available in Product Search API categories to build static category lists in your UI. Note that the categories and subCategories data in the API response are only meant to filter the returned results. Both of these objects can return empty and are not guaranteed in every response.