API

Email finder API

Send a first and last name with a company domain or name, and get the person's work email back. Every address is verified before it's returned, and you pay only when one is found.

Request · POST /api/v2/find-email
curl -X POST "https://api.skrap.ai/api/v2/find-email" \  -H "x-api-key: $SKRAP_API_KEY" \  -H "Content-Type: application/json" \  -d '{"firstName":"Jane","lastName":"Doe","domain":"example.com"}'
Response
200 OK
1{2  "emails": [{ "email": "[email protected]", "status": "valid" }],3  "status": "valid",4  "domainStatus": "valid",5  "pendingRefinement": false,   // true: poll /api/v1/find-email/refinement/{requestId}6  "requestId": "req_…",7  "retryable": false8}
  • Verified before it's returned

    Each candidate address is checked against the company's mail server first, so you get a status, not a guess dressed up as a result.

  • Charged only when found

    1 credit when a Valid or Risky email comes back. Not found costs nothing.

  • Domain or company name

    A domain gives the best results; a company name (with an optional location hint) works too, and ambiguous names ask you to confirm.

  • Bulk finder jobs

    Up to 25,000 people per job, processed in the background, with polling, CSV download and a completion webhook.

  • Slow servers handled

    When a mail server answers slowly, the first response is free and marked pendingRefinement; poll once for the final answer.

  • Search, then find

    Search leads and companies for free, then get the email of a result for 1 credit when it's found.

How a find works

  1. 1Company: the domain you send, or the company name resolved to its domain.
  2. 2Candidates: likely addresses in the company's email format (first.last@, flast@…), learned from confirmed addresses where Skrap.ai has them.
  3. 3Verification: candidates are checked with the same engine as the verification API, and published addresses that match the person are used as evidence.
  4. 4Answer: the best verified address with its status, or nothing (and no charge).

Credits

ResultCost
Find — email found (Valid or Risky)1 credit
Find — not foundFree
Lead & company searchFree
Email of a search result1 credit when found

New accounts get 100 free credits, and the free email finder works without an account. API keys come with every paid plan and credit pack: create one in the app under Settings → API keys & MCP and send it in the x-api-key header. See pricing for plans.

Statuses

StatusMeaning
validThe mailbox exists and accepts mail.
riskyDeliverable but uncertain — catch-all domains, full mailboxes, mail servers that would not confirm the mailbox, and best guesses in the company's email format. Send with care.
invalidThe address or domain cannot receive mail. Free.
unknownWe could not confirm the domain has a mail server (its DNS did not answer), or there was no address to give. Free. When retryable is true, the cause was temporary (try again later).

Rate limits

PlanRequests
Free30 requests / minute per key
Professional120 requests / minute per key
Enterprise600 requests / minute per key
CustomAgreed with sales

Frequently asked questions

What do I need to send to find an email?

A first and last name (or a full name) plus the company's domain. A company name works when you don't have the domain; add a location to tell similar companies apart.

Am I charged when no email is found?

No. A find costs 1 credit only when it returns a Valid or Risky email. Not found, and pending answers, cost nothing.

Why is a found email sometimes Risky?

Some companies accept mail for every address (catch-all) or won't confirm mailboxes. Then the best address in the company's format comes back Risky, so you can decide whether to send. See catch-all domains.

Can I find emails in bulk?

Yes. POST up to 25,000 people to /api/v1/bulk-find, then poll the task or use the bulk_job.completed webhook and download the results.

Can I use it from Clay, Zapier or Google Sheets?

Yes: there's a Clay recipe, Zapier actions and a Google Sheets add-on, all using the same credits.

Is finding work emails legal?

Finding a business address is lawful in most places, but how you use it is regulated (GDPR, CAN-SPAM and similar). See GDPR & data protection and honour opt-outs; Skrap.ai has a do-not-contact list for that.

Your Next Customer Is JustOne Search Away

No credit card required100 one-time free credits