Comment on page
pagequery parameter to control which page of results you want (eg
page=2, etc). By default there are 25 results per page; you can use the
per-pageparameter to change that to any number between 1 and 200.
To use cursor paging, you request a cursor by adding the
cursor=*parameter-value pair to your query.
The response to your query will include a
next_cursorvalue in the response's
metaobject. Here's what it looks like:
"results" : [
// the first page of results
To retrieve the next page of results, copy the
meta.next_cursorvalue into the cursor field of your next request.
- Get the next page of results using a cursor value:
This second page of results will have a new value for
meta.next_cursor. You'll use this new value the same way you did the first, and it'll give you the second page of results. To get all the results, keep repeating this process until
meta.next_cursoris null and the
resultsset is empty.
Don't use cursor paging to download the whole dataset.
- It's bad for you because it will take many days to page through a long list like /works or /authors.
- It's bad for us (and other users!) because it puts a massive load on our servers.