Deeplead API

B2B data over REST: search 23M+ local businesses, companies and people, enrich a company by its domain, and find work emails and phone numbers. JSON in, JSON out, one API key, credits charged only when we find something.

Get an API key API reference

Quickstart

Find a work email

curl https://www.deeplead.io/api/v1/persons/email/find \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Jane Doe","domain":"acme.com"}'

Response

{
  "found": true,
  "chargedCredits": 1,
  "email": "jane.doe@acme.com",
  "alternateEmails": [],
  "name": "Jane Doe",
  "jobTitle": "Head of Marketing",
  "companyName": "Acme",
  "companyWebsite": "acme.com",
  "linkedin": "https://www.linkedin.com/in/janedoe"
}

Interactive API reference OpenAPI 3 spec

Access and pricing

API key: Start the 3-day trial on the Starter plan ($37/month, 2,000 credits a month), then create keys under My Account → API. Calls spend the same credits as the app.
Free tier: Prefer to try it without a card? The same API runs on RapidAPI with a free BASIC plan. Deeplead on RapidAPI
Authentication: Send your key as "Authorization: Bearer YOUR_API_KEY" to https://www.deeplead.io/api/v1. Call it from your server; keys must never ship to a browser.
Limits and retries: Up to 120 requests per minute per account. Send an Idempotency-Key header on paid calls and a retry never charges twice. Every response reports chargedCredits; GET /credits returns your balance.

Endpoints

Businesses

POST /businesses/search
Search local businesses from Google Business Profiles
23M+ businesses with ratings, reviews, website contacts, socials and ad pixels. 30 per page. Charges 1 credit per business with an email or phone and 0.5 per business without. saveToContacts also stores them in your contacts.

Organizations

POST /organizations/search
Search organizations, or look them up by domain
Charges 0.5 credits per returned organization. limit 0 returns only totalCount, free.
POST /organizations/enrich
Enrich a company from its domain
Returns the company's firmographics, socials and website data. Charges 0.5 credits only when the company is found.
POST /organizations/{organizationId}/decision-maker
Find the decision maker of an organization with a verified email
Charges 2 credits only when a decision maker is found. Can take a few minutes.

Persons

POST /persons/search
Search persons with their emails and phones
Covers professional contacts only: people in their role at a company, not private individuals. Returns only people with an email or phone, with full contact data, and charges 1 credit per returned person. Page with nextOffset. limit 0 returns only totalCount, free. saveToContacts also stores them in your contacts, where people you already had are refunded.
POST /persons/lookup
Look up one person by LinkedIn URL, email, or name and company domain
Returns the person with their emails, phones, role and company. Covers professional contacts only: people in their role at a company, not private individuals. Charges 1 credit only when the person is found with an email or phone. saveToContacts also stores them in your contacts.
POST /persons/email/find
Find a person's work email by LinkedIn URL, or full name and company domain
Charges 1 credit only when an email is found.
POST /persons/phone/find
Find a person's phone number by LinkedIn URL, email, or full name and company domain
Covers professional contacts only: people in their role at a company, not private individuals. Charges 2 credits only when a phone number is found.

Contacts

POST /contacts
Save your own contacts or organizations
Free. Existing contacts are matched and kept, never duplicated.
GET /contacts
List your contacts in a stable order; page with nextBefore

Deliverability

POST /deliverability/tests
Start an inbox placement test for a mailbox you send from
Send one email from the mailbox you want to test to every address in seedEmails, with the testId anywhere in the body, then poll /deliverability/tests/{testId} about once a minute to see whether it landed in the inbox, spam or a tab at Gmail, Outlook and other providers. Most seeds report within 2-5 minutes; the test closes 60 minutes after it starts. Charges 25 credits.
GET /deliverability/tests/{testId}
Where the test email landed at each seed mailbox
Poll about once a minute while status is waiting. placement is inbox, spam, promotions, social, updates or forums, or missing while the email has not arrived; score is the inbox share from 0 to 10 once the test is completed. rspamd is the content filter verdict with its matched rules, when a seed reports one.

Account

GET /credits
Current credit balance

AI agents

Same endpoints as MCP tools

Claude, ChatGPT, Cursor and your own agents can call every endpoint above as a tool through our hosted MCP server, signing in with OAuth or the same API key. Connect over MCP

Data sources and privacy

Where the data comes from

Business listings, company websites, public professional profiles and licensed B2B data providers, limited to professional contact and role data. Anyone can remove themselves at https://www.deeplead.io/opt-out, which applies to the API immediately. Details in the privacy policy.