Quickstart

Make your first API request in less than 2 minutes.

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.

Welcome to BlitzAPI! In this guide, we will perform a simple but powerful task: finding a verified professional email from a LinkedIn profile URL.

Prerequisites: You need an API Key. You can grab one from your BlitzAPI Dashboard.

Choose your client

BlitzAPI is a standard REST API, so you can use it with any language.For Python or JavaScript/TypeScript, the fastest path is the official SDK — it handles auth, retries, rate limiting, and pagination for you. Prefer cURL for a quick terminal test, or call the REST API directly from any other language.

Install the SDK

Skip this step if you’re using cURL.

pip install blitz-api-py

npm install blitz-api-js

See the SDK guides for the full API surface.

Send the request

We will use the POST /v2/enrichment/email endpoint. Replace YOUR_API_KEY with your actual key, or set it as the BLITZ_API_KEY environment variable (the SDKs read it automatically).

curl --request POST \
  --url https://api.blitz-api.ai/v2/enrichment/email \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
  "person_linkedin_url": "https://www.linkedin.com/in/example-person"
}'

from blitz_api import BlitzAPI

client = BlitzAPI(api_key="YOUR_API_KEY")  # or set BLITZ_API_KEY

result = client.enrichment.email(
    person_linkedin_url="https://www.linkedin.com/in/example-person",
)

print(result.found, result.email)

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

const client = new BlitzAPI({ api_key: "YOUR_API_KEY" }); // or set BLITZ_API_KEY

const result = await client.enrichment.email({
  person_linkedin_url: "https://www.linkedin.com/in/example-person",
});

console.log(result.found, result.email);

Check the response

You should receive a JSON object containing the verified email and its status.

{
  "found": true,
  "email": "jane.doe@acme.com",
  "all_emails": [
    {
      "email": "jane.doe@acme.com",
      "job_order_in_profile": 1,
      "company_linkedin_url": "https://www.linkedin.com/company/acme",
      "email_domain": "acme.com"
    }
  ]
}

Response Fields:

Field	Type	Description
`found`	`boolean`	`true` if a verified email was found. `false` if no email exists in the database.
`email`	`string`	The primary verified work email address. `null` if `found: false`.
`all_emails`	`array`	All verified email addresses found for this profile (usually 1).
`all_emails[].email`	`string`	The verified email address.
`all_emails[].job_order_in_profile`	`integer`	Position of the associated job in the person’s LinkedIn profile (1 = current job).
`all_emails[].company_linkedin_url`	`string`	LinkedIn URL of the company associated with this email.
`all_emails[].email_domain`	`string`	Domain of the email address.

All paid plans include unlimited requests — included in your flat monthly subscription.

What just happened?

Authentication: You passed your key via the x-api-key header.
Identity Matching: BlitzAPI matched the LinkedIn profile URL against our verified B2B dataset.
Verification: We validated email deliverability (SMTP handshake) before returning it.

Next Steps

Now that you have the basics down, explore our more advanced features.

Official SDKs

Typed Python and TypeScript/JavaScript SDKs with built-in retries, rate limiting, and pagination.

Connect Your AI (MCP)

Let Claude, Cursor, or any MCP client call Blitz endpoints for you — one-click setup.

Find People

Source decision-makers across an entire ICP in one call — combine company and person filters.

Waterfall Search

Don’t have a profile URL? Find the best contact at a known company by cascade.

Build an ICP List

End-to-end recipe: Find People → enrich → CRM-ready output.

Bulk Enrichment

Learn how to process thousands of leads efficiently.

Introduction

Getting Started

Core Concepts

Recipes (Use Cases)

Integrations

Appendix

Quickstart

Quickstart

What just happened?

Next Steps

Official SDKs

Connect Your AI (MCP)

Find People

Waterfall Search

Build an ICP List

Bulk Enrichment

​Quickstart

​What just happened?

​Next Steps

Official SDKs

Connect Your AI (MCP)

Find People

Waterfall Search

Build an ICP List

Bulk Enrichment

Quickstart

What just happened?

Next Steps