Skip to main content
Every list endpoint returns the same envelope:

Paging through a list

Ask for the first page without a cursor. While has_more is true, ask again with cursor set to the next_cursor you were given, and the same filters. limit sets the page size, from 1 to 100. The default is 20.

Which lists page

Cursors

  • Cursors are opaque. Pass them back exactly as you got them. Their contents may change without notice.
  • A cursor belongs to its list. Use it with the same endpoint and the same filters. Anything else returns cursor_invalid.
  • Pages hold steady while you read them. Each cursor marks a position in the list, so a post published while you page lands at the top, not in the middle of your next page, and nothing is skipped or repeated.