Page through a list

Send the cursor back exactly as you received it.

Every list returns one page, a cursor, and has_more. The envelope and data carry the same two values. To get the next page, repeat the request with cursor set to the value you got.

  • Treat the cursor as opaque. Do not parse it, build one, or store it long term.
  • has_more: false and cursor: null means you have the whole list.
  • Each page costs the usual price for that endpoint, whatever its size. A platform may return fewer rows than limit and still have more. Trust has_more, not the page length.
  • Keep every other parameter the same. A new sort, region or search term is a new list. Drop the cursor.
  • A cursor from another API is not usable here. Start that list from the first page. Older parameter names are accepted as cursor. The pagination guide lists them.

Pages follow max_age_days like any other request. A cached page that is still fresh costs nothing and returns the cursor from when it was fetched.

Full detail: Pagination.