Basics

  • By default, search endpoints for Profiles and Companies return 100 items per page.
  • The amount can controlled via limit parameter.
  • The maximum is 1000 items.

Pagination token

When the number of items in the search results exceeds the page limit, a paginationToken is returned. This token allows iterating through multiple pages of search results.

Pagination token supports Point in Time functionality (PIT). PIT allows you to take a “snapshot” of the data at a specific moment. This creates a fixed view of the index, preventing changes from affecting your search results when iterating multiple result pages. PIT expires after 5 minutes from running the search query.

Point in time can be controlled in the query with an additional stable_pagination parameter. When set to false, the search results won’t be using PIT. That means when iterating through multiple pages of search results, you might encounter the same items on subsequent pages. However, search queries without PIT will have faster response times.

We advise using "stable_pagination: true" only for queries where you expect many search results and you need to iterate through all of them. For example when you need to pull all profiles with a certain job title or all employees of a large company.

For queries that are more targeted, we highly recommend using "stable_pagination": false".

You can also consider increasing the limit value for some queries to avoid pagination altogether. The maximum value is 1000.

Currently, PIT is set to true by default. However, as of April 1st 2025, the logic will change to false by default.