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.

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" }

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 Settings → API & MCP. 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

Setup

  • GET /setup

    What 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-profile

    Read 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-profile

    Change your company profile

    Only the fields sent change. Ideas suggested before keep their audience; suggest again for ideas from the new profile.

  • POST /settings/sender

    Choose 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/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.

Websites

  • POST /websites/contacts

    Find 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/pixels

    Find 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-pixel

    Find 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-registration

    Find 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 /contacts

    Save your own contacts or organizations

    Free. Existing contacts are matched and kept, never duplicated.

  • GET /contacts

    List 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 /campaigns

    List 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 /campaigns

    Create 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}/status

    Turn 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}/recipients

    Add 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/remove

    Take 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 /replies

    List 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}/answer

    Answer 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-ideas

    List 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/suggest

    Suggest 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}/audience

    Set 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}/radius

    Set 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/launch

    Draft 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/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, 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 /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 removes them from the API within an hour. Details in the privacy policy.