Paging

All V3 search endpoints share the same paging parameters. The API supports offset-based and cursor-based paging.

Offset-based paging

Use offset-based paging to retrieve a small dataset only (up to 10,000 records).

• page: the page number to retrieve. Page numbering starts at 1.
• pageSize: the number of results per page, range 1–100 (default 10).

Example — the top 10 most influential research products containing "knowledge graphs":

/v3/research-products?search="knowledge graphs"&page=1&pageSize=10&sortBy=influence DESC

{
  "header": {
    "numFound": 18828,
    "maxScore": 9.69,
    "queryTime": 497,
    "page": 1,
    "pageSize": 10
  },
  "results": [ ... ]
}

Cursor-based paging

Use cursor-based paging to retrieve a large dataset (more than 10,000 records).

• cursor: cursor-based pagination, initial value *.

Example:

/v3/research-products?search="knowledge graphs"&pageSize=10&cursor=*&sortBy=influence DESC

{
  "header": {
    "numFound": 18828,
    "queryTime": 476,
    "pageSize": 10,
    "nextCursor": "AoM/DzAwMDY0YWFiYmRhOTo6NTlmMDlkYjVlOGY3YmZhYzg4ODI3ZjNlYjMyMGNmYTkIMRjpqT8P"
  },
  "results": [ ... ]
}

Use the nextCursor value to retrieve the next page of results.

note

maxScore is only present when results are ranked by relevance. If you sort by any other field (for example sortBy=influence DESC), it is omitted from the header — as in the cursor example above.