Pagination

Pagination is the process of dividing a large set of results into smaller, manageable chunks called pages. Each page will contain up to 1,000 results.

The Discover API uses cursors to paginate through results. A cursor is an opaque token that marks your position in a result set, allowing you to pick up exactly where the previous response left off. Rather than using page numbers or offsets, cursors provide a stable and efficient way to traverse large datasets — even as new data is added or removed between requests.

How to use the cursor

Discover searches that yield more results than can fit on a single page will return a nextCursor property.

Request
{
    "data": [
		// omitted for brevity
    ],
    "hasProblems": false,
    "isRetryable": true,
    "isSuccess": true,
    "metadata": null,
    "nextCursor": "OS4wfDE2NDg2ODQ4MDAwMDB8NDQxMjEzODY2LTk3ZDYxZmNjM2FjMWQ1NzBiNTY1ZmEwMTVjMzg3ZjM0"
}

Pass this value into the cursor property of your next request to retrieve the following page of results, as shown below:

Response
{
  "company": {
    "country": {
      "or": [
        "united states"
      ]
    },
    "industry": {
      "or": [
        "hospital & health care"
      ]
    },
  },
  "metadata": null,
  "cursor": "OS4wfDE2NDg2ODQ4MDAwMDB8NDQxMjEzODY2LTk3ZDYxZmNjM2FjMWQ1NzBiNTY1ZmEwMTVjMzg3ZjM0"
}

When nextCursor is null, there are no additional pages to fetch.

Do not modify any filter criteria in between pages. Doing so will result in unpredictable behavior.