Official SDKs - BlitzAPI - The API Engine for every GTM Playbook

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.

Blitz ships official, fully typed SDKs for Python and TypeScript / JavaScript. Both wrap the same v2 REST API, use the exact same snake_case field names you see in the API reference, and handle the boilerplate for you — client-side rate limiting, retries with backoff on 429/5xx, auto-pagination, and a typed error hierarchy.

Python SDK

pip install blitz-api-py — sync + async clients, Pydantic v2 models, Python 3.10+.

TypeScript / JavaScript SDK

npm install blitz-api-js — Zod-validated types, ESM + CJS, Node 20+.

Install

pip install blitz-api-py
# or: uv add blitz-api-py

npm install blitz-api-js
# or: pnpm add blitz-api-js  /  yarn add blitz-api-js

Why use an SDK?

Fully typed — Pydantic v2 (Python) / Zod-inferred types (TS) for every request filter and response field, with editor autocomplete.
Auto-pagination — iterate every result across pages without writing a cursor or page loop.
Resilient by default — automatic retries with backoff on 429 and 5xx, plus a typed exception hierarchy.
Client-side rate limiting — a single client instance stays under your per-endpoint request-per-second limit.
Forward-compatible — fields the API adds later are preserved, never dropped or rejected.

Never expose your API key in client-side code (browsers, mobile apps). Both SDKs send the key in the x-api-key header — always call Blitz from your backend. See Authentication.

Quickstart

Both SDKs read the key from the BLITZ_API_KEY environment variable (or take it explicitly), then expose the same four namespaces.

from blitz_api import BlitzAPI

with BlitzAPI() as client:
    # LinkedIn profile URL -> verified work email.
    email = client.enrichment.email(
        person_linkedin_url="https://www.linkedin.com/in/example-person",
    )
    if email.found:
        print(email.email)

import { BlitzAPI } from "blitz-api-js";

const client = new BlitzAPI();

// LinkedIn profile URL -> verified work email.
const email = await client.enrichment.email({
  person_linkedin_url: "https://www.linkedin.com/in/example-person",
});
if (email.found) console.log(email.email);

Endpoint coverage

Every v2 endpoint is a typed method, grouped into four namespaces. Method names and fields are identical across both SDKs.

Namespace	Method	REST endpoint	API reference
`account`	`key_info()`	`GET /v2/account/key-info`	Get API key details
`search`	`people()`	`POST /v2/search/people`	Find people
`search`	`companies()`	`POST /v2/search/companies`	Company search
`search`	`employee_finder()`	`POST /v2/search/employee-finder`	Employee finder
`search`	`waterfall_icp()`	`POST /v2/search/waterfall-icp-keyword`	Waterfall ICP
`enrichment`	`email()`	`POST /v2/enrichment/email`	Find work email
`enrichment`	`phone()`	`POST /v2/enrichment/phone`	Find mobile & direct phone
`enrichment`	`email_to_person()`	`POST /v2/enrichment/email-to-person`	Reverse email lookup
`enrichment`	`phone_to_person()`	`POST /v2/enrichment/phone-to-person`	Reverse phone lookup
`enrichment`	`company()`	`POST /v2/enrichment/company`	Company enrichment
`enrichment`	`domain_to_linkedin()`	`POST /v2/enrichment/domain-to-linkedin`	Domain to LinkedIn
`enrichment`	`linkedin_to_domain()`	`POST /v2/enrichment/linkedin-to-domain`	LinkedIn to domain
`utils`	`current_date()`	`POST /v2/utils/current-date`	Current date & time
`utils`	`company_employment_distribution()`	`POST /v2/utils/company-employment-distribution`	Employment distribution

Next steps

Python SDK guide

Install, auth, async, pagination, configuration, and error handling for blitz-api-py.

TypeScript / JavaScript SDK guide

Install, auth, pagination, configuration, and error handling for blitz-api-js.

Pagination

Stream results across pages and cap spend with max_items.

Rate limits & retries

The client-side limiter, automatic 429/5xx retries, and timeout behavior.

Authentication

How API keys work and how to health-check your key.

API reference

Full request/response schemas and an interactive try-it console.

Python SDK

TypeScript / JavaScript SDK

​Install

​Why use an SDK?

​Quickstart

​Endpoint coverage

​Next steps

Python SDK guide

TypeScript / JavaScript SDK guide

Pagination

Rate limits & retries

Authentication

API reference

Install

Why use an SDK?

Quickstart

Endpoint coverage

Next steps