Is there a limit to the number of results that can be requested?

Yes, you may request a maximum of 10,000 results. However, we recommend you request far fewer than that for performance and payload size reasons.

This recommendation stems from the central motivation for the Constructor Product Discovery service - to increase business KPIs for eCommerce search. This goal means we handle things differently than other general purpose search tools.

We have several motivations for limiting the result size that relate to the goal of increasing business KPIs like conversion, RPV, etc.:

• Return results as quickly as possible -- both the first page and subsequent pages.
• Prioritize speed and user experience on the pages a customer are actually likely to use to find what they're looking for.
• Use personalization, result optimization, machine learning, and merchant rules to show the products that move business KPIs first.

All of these factors led us to focus on the top results for a given query. Supporting queries for larger result sets would imply different architectural decisions with regards to intermediate caching, result hydration and applying of the suite of optimization capabilities.