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.
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.
Iterate the returned page to walk every match across all pages. Each page is fetched on demand, through the client’s rate limiter.
# The SDK fetches each subsequent page for you.for person in client.search.people(people={"job_level": ["VP"]}): print(person.full_name)
max_results is the page size (1–50), not a total — and on the Trial plan the API bills 1 credit per result returned (Unlimited plans are flat-rate). 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). Bound it with max_items, break out of the loop, or drive pages manually (below).
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.
# Stop after 200 results, across however many pages that takes.for person in client.search.people(people={"job_level": ["VP"]}).auto_paging_iter(max_items=200): print(person.full_name)
Take the first page, inspect totals and cursors, and fetch the next page yourself when you need explicit control (your loop, your spend).
# First page + manual paging.page = client.search.people(people={"job_level": ["VP"]}, max_results=50)print(page.results, page.cursor) # items on this page; cursor is None once exhaustednxt = page.get_next_page() # None once exhausted# Or walk pages and inspect totals as you go.for p in client.search.companies(company={"industry": {"include": ["Software Development"]}}).iter_pages(max_pages=5): print(p.total_results, len(p.results), p.cursor)
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.
