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.
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"
}Setup
GET /setupWhat is left to set up before campaigns send
Start here for a new account, and read it again after each step. Work through the first step not done: sender: ask the customer, then POST /settings/sender. company_profile: GET /company-profile, then fill what its todo names with PATCH /company-profile. campaign_ideas: POST /campaign-ideas/suggest, then GET /campaign-ideas. launch: show the customer the ideas, change audience or radius where they ask, then POST /campaign-ideas/launch with the ones they pick.
GET /company-profileRead your company profile
Campaign ideas and every email are written from it. Right after signup, website research fills it in a few minutes; poll about once a minute while researching is true.
PATCH /company-profileChange your company profile
Only the fields sent change. Ideas suggested before keep their audience; suggest again for ideas from the new profile.
POST /settings/senderChoose who your emails come from
Emails from our warmed-up Deeplead Inboxes go out under this name or from our sender profiles. Nothing sends from them until this is chosen. Ask the customer; never pick for them.
Businesses
POST /businesses/searchSearch 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/searchSearch organizations, or look them up by domain
Charges 0.5 credits per returned organization. limit 0 returns only totalCount, free.
POST /organizations/enrichEnrich 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-makerFind 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/searchSearch 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/lookupLook 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/findFind 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/findFind 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.
Websites
POST /websites/contactsFind the emails, phones and social profiles published on a company website
Reads what our own crawl of the website found, so it answers in under a second and never visits the site during the call. A website that many businesses share (a site builder, a booking platform) has no contacts. Charges 0.5 credits only when an email or phone is found.
POST /websites/pixelsFind the ad and analytics pixels a website runs
Checks the homepage and every Google Tag Manager container it loads, nested ones included, for meta, tiktok, openai, google_analytics, google_ads, microsoft_ads, linkedin, pinterest, snapchat, x, reddit, hotjar, microsoft_clarity, callrail. Containers that 50 or more websites load belong to a platform or agency and are left out. Answers from the last check when the website was checked before (checkedAt), otherwise checks it during the call, which can take up to 20 seconds. Charges 0.25 credits when the homepage answered, also when it runs no pixels; a homepage that never answers is free.
POST /websites/by-pixelFind every website that runs the same ad or analytics pixel
Lists the websites we checked whose homepage or Google Tag Manager containers load the pixel, so websites with one owner, dealer group or agency show up together. Takes a pixel id as /websites/pixels returns it. 50 per page, sorted by domain, with the total. Charges 0.1 credits per returned website; a pixel on no checked website is free.
POST /websites/domain-registrationFind when a website’s domain was registered and transferred, until when, and at which registrar
Answers from the registry's last RDAP answer we stored, for over 6 million domains. A .com or .net domain never looked up is asked at its registry during the call; other domains answer only from stored answers. A subdomain answers for the domain it belongs to. A recently registered or transferred domain often means a new business or a new owner. Charges 0.05 credits when the registry knows the domain; a miss is free.
Contacts
POST /contactsSave your own contacts or organizations
Free. Existing contacts are matched and kept, never duplicated.
GET /contactsList your contacts, newest first; page with nextBefore
search and campaignId narrow the list, and totalCount counts every match, so finding a contact or counting them takes one call. limit 1 is enough for a count. To check many businesses or domains at once, e.g. which of them a campaign already has, send them all in searches: searchCounts says per term how many contacts match, in one call.
Campaigns
GET /campaignsList your email campaigns, newest first, with their status and counts
GET /campaigns/{campaignId}One campaign with its steps, sender pool and counts
The counts are for a one-time look. To watch for new replies, call /replies with this campaignId and pass the first replyId of the last call as after, instead of polling this campaign.
POST /campaignsCreate an email campaign; it starts paused
Free. For emails and recipients you bring yourself; to have Deeplead find the recipients and draft the emails, launch an idea with /campaign-ideas/launch instead. Add recipients with /campaigns/{campaignId}/recipients, then turn it on with /campaigns/{campaignId}/status.
PATCH /campaigns/{campaignId}Change a campaign’s name, steps, sender pool or daily limit
Only the fields sent change. steps replaces every step: send a step with its id to keep its personalization and past versions.
POST /campaigns/{campaignId}/statusTurn a campaign on, pause it, or archive it
active needs a sender pool with an active inbox. Setting paused on an archived campaign unarchives it.
POST /campaigns/{campaignId}/recipientsAdd your contacts to a campaign
Free. Contacts already in the campaign, without a usable email or not among your contacts are skipped.
POST /campaigns/{campaignId}/recipients/removeTake contacts out of a campaign
They get no further emails from it. Contacts not in the campaign are skipped. Replies, unsubscribes and bounces they already had stay in your inbox and keep blocking their address.
Replies
GET /repliesList the replies your campaigns received, newest first
Bounces are left out. To watch for new replies, keep the first replyId of a call and pass it as after on the next one, instead of polling /campaigns/{campaignId} for its counts. Page back with nextBefore.
POST /replies/{replyId}/answerAnswer a reply by email
Sends your text right away from the inbox the reply came to, in the same thread, with their email quoted below it. Sent mail cannot be taken back.
Campaign ideas
GET /campaign-ideasList your campaign ideas and how far each got
Poll about once a minute while suggesting is true or an idea is drafting or launching.
GET /campaign-ideas/{ideaId}One campaign idea with its draft: audience size and example emails
POST /campaign-ideas/suggestSuggest campaign ideas from your company profile
Free. Answers at once; the ideas show in /campaign-ideas once suggesting is false, replacing every idea not launched yet. With segment it adds ideas for that audience instead.
POST /campaign-ideas/{ideaId}/audienceSet the Google Maps categories a Maps idea reaches
On a launched idea, recipients not contacted yet who no longer fit are taken out; removedRecipients counts them.
POST /campaign-ideas/{ideaId}/radiusSet how many miles around your home city a Maps idea reaches
On a launched idea, recipients not contacted yet outside the new radius are taken out; removedRecipients counts them.
POST /campaign-ideas/launchDraft each idea, create its campaign and turn it on
Answers at once. Each idea shows launching in /campaign-ideas, then launched with its campaign once created.
DELETE /campaign-ideas/{ideaId}Delete a campaign idea that has no campaign
An idea that launched a campaign, or is launching, stays; archive its campaign instead.
Deliverability
POST /deliverability/testsStart 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, missing while the email has not arrived, or unreadable while we could not read that seed mailbox; score is the inbox share from 0 to 10 once the test is completed, leaving unreadable seeds out. rspamd is the content filter verdict with its matched rules, when a seed reports one.
Account
GET /creditsCurrent credit balance
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
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 removes them from the API within an hour. Details in the privacy policy.