Skip to main content
Agents & LLMs: a Markdown version of this page is available by appending .md to the URL, and the full documentation index is at llms.txt.
The search methods return an auto-paginating page. Iterate it and the SDK fetches each subsequent page for you — no cursor or page bookkeeping. This works identically in Python and TypeScript; only the syntax differs.

Which methods paginate

Cursor vs page is an implementation detail — the SDK exposes the same interface for both. Cursors are stable even if new records are added between calls, so you won’t see duplicates.
company.tam_by_jobs pages carry no total_results (the API omits it for TAM), so iterate until the cursor is null. job.min_per_company can also make a page come back partial: keep paging rather than stopping on a short page.

Stream every result

Iterate the returned page to walk every match across all pages. Each page is fetched on demand, through the client’s rate limiter.
max_results is the page size (1–50), not a total, and the API bills 1 record per result returned. A bare loop streams every match up to the server-side cap (people / companies: 50,000 results or 1,000 pages; employee finder: 10,000; jobs: 5,000). Bound it with max_items, break out of the loop, or drive pages manually (below).

Bound how much you pull

max_items is a client-side total cap — it stops the SDK fetching once reached and is never sent on the wire. Use it (with max_results tuned for page size) to keep spend predictable.

Per-page and manual control

Take the first page, inspect totals and cursors, and fetch the next page yourself when you need explicit control (your loop, your spend).

Page object shape

  • Python — items are on page.results; cursor on page.cursor. The page types (CursorPage, PageNumberPage, and their Async* variants) are exported from blitz_api.
  • TypeScript — items are on page.data; the full parsed response (snake_case, 1:1 with the API — e.g. total_results, page, total_pages) is on page.response.

Next steps

Rate limits & retries

How the client-side limiter and automatic 429/5xx retries work.

Python SDK

Full method reference for blitz-api-py.

TypeScript / JavaScript SDK

Full method reference for blitz-api-js.

API reference

Request/response schemas and a try-it console.