Pagination

List endpoints use offset paging. The live discovery feed uses cursor paging so rows are never skipped or repeated while new hosts are landing.

Offset paging

Pass limit and offset. Best for stable lists such as domains, platforms and scan history. Stop when a page returns fewer rows than the limit.

Cursor paging

The new-subdomain feed returns meta.next_cursor. Send those values back as query parameters on the next call and repeat until the cursor is absent or the page is empty.

Sizing your pages

2,000 rows per page is the sweet spot for the discovery feed. For a complete program dump use the export endpoint instead — it streams and never times out.

Authentication

Raw lists

meta.next_cursor

{
  "data": [ /* rows */ ],
  "meta": {
    "limit": 2000,
    "count": 2000,
    "next_cursor": {
      "before_ts": "2026-09-05T09:41:22.108Z",
      "before_id": "0f0a…"
    }
  },
  "request_id": "…"
}