Result Limits in Cludo Search
Cludo search includes an upper limit on how many results can be requested in a single search. This is based on a technical constraint in the search engine used to process Cludo queries. This article explains what the limit is, why it exists, and what you should expect when building search experiences that use deep pagination.
Our search engine sets a default limit of 10.000 results for any individual search request.
What happens if the limit is exceeded?
If a search request asks for results beyond this limit, Cludo Search will reject the request and return an error. For example:
- Requesting more than 10.000 results
- Requesting page numbers that exceed what ten thousand results can support
- Using pagination controls that allow users to jump to very high page numbers
In these cases, Cludo will return an error message so you can identify that the limit has been reached.
Why deep pagination is not recommended
Even outside of the technical restriction, deep pagination is rarely needed in real world search behaviour.
Because of this, Cludo does not display more than one thousand pages in the user interface. This prevents users from navigating into invalid page ranges and avoids unnecessary errors.
If you are building a custom integration or calling Cludo APIs directly:
- Do not request more than ten thousand results
- Ensure your pagination controls cannot generate page numbers beyond the valid range
- For large datasets, consider using filtering, grouping, or a more efficient method such as incremental data loading instead of deep pagination
These steps will prevent errors and ensure consistent performance.