Pagination

List endpoints page one of two ways. The reference lists the exact query parameters per endpoint — check there rather than guessing.

Page and limit

The common style. page starts at 1.

Skip and limit

Offset style, used by some older list endpoints. skip is a row count, not a page number.

Walking a whole collection

Stop when a page returns fewer items than you asked for. That works under both styles and does not depend on a total the endpoint may not return.

JavaScript

Python

PHP

Rate limits while paging

A full catalogue walk at 100 per page is well inside the limit, but a parallel crawl is not. Page sequentially, or see Rate limits before fanning out.

Filtering instead of paging

Most list endpoints accept filters — status, query, start_date / end_date, days. Filtering server-side beats paging through everything and discarding most of it, and it is kinder to both of us.

Page and limit#

Skip and limit#

Walking a whole collection#

Rate limits while paging#

Filtering instead of paging#

Page and limit

Skip and limit

Walking a whole collection

Rate limits while paging

Filtering instead of paging