Skip to main content
All list and search endpoints use cursor pagination.

​
Response Shape

Responses include:
  • pagination.cursor: opaque cursor for the next page (omitted when done)
  • pagination.has_more: boolean
  • next_page_url: fully-formed URL to fetch the next page

​
Using page_token

Pass a page_token query parameter to resume from a cursor: 
curl -s \
  -H "X-API-Key: sk_..." \
  "$AD_DATASETS_BASE_URL/api/v2/ads?limit=50&page_token=<token>" | jq

​
Limits

  • Default limit: 50
  • Max limit is capped server-side