Quickstart - Email Finder Verifier API

Create an account at my.emailfinderverifier.com/sign-up. You can sign up with Google or with your work email.

Copy your API key

Your key is shown on the Get started page right after you sign up, and you can create more under API keys in the dashboard. Keep it secret: anyone with the key can spend your balance.

Make your first request

Verify an address. Replace YOUR_API_KEY with your key.

curl "https://api.emailfinderverifier.com/api/v1/verify?email=jane@acme.com" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

r = requests.get(
    "https://api.emailfinderverifier.com/api/v1/verify",
    params={"email": "jane@acme.com"},
    headers={"X-API-Key": "YOUR_API_KEY"},
    timeout=120,
)
r.raise_for_status()
print(r.json())  # {"verified": true, "esp": "Outlook"}

const url = new URL("https://api.emailfinderverifier.com/api/v1/verify");
url.searchParams.set("email", "jane@acme.com");

const res = await fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
console.log(await res.json()); // { verified: true, esp: "Outlook" }

Find an email

Pass a first name, last name and company domain. You get the address back only when it’s verified; otherwise email is null.

curl -G "https://api.emailfinderverifier.com/api/v1/find" \
  --data-urlencode "domain=acme.com" \
  --data-urlencode "first_name=Jane" \
  --data-urlencode "last_name=Doe" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

r = requests.get(
    "https://api.emailfinderverifier.com/api/v1/find",
    params={"domain": "acme.com", "first_name": "Jane", "last_name": "Doe"},
    headers={"X-API-Key": "YOUR_API_KEY"},
    timeout=120,
)
print(r.json())  # {"email": "jane.doe@acme.com", "esp": "Google"}

const url = new URL("https://api.emailfinderverifier.com/api/v1/find");
url.search = new URLSearchParams({ domain: "acme.com", first_name: "Jane", last_name: "Doe" });

const res = await fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" } });
console.log(await res.json()); // { email: "jane.doe@acme.com", esp: "Google" }

Some checks take a while to come back. Set your HTTP timeout to at least 60 seconds, and 120 seconds for generic inboxes.

Next steps

verified: false doesn’t always mean the address is bad. Read Verify an email before you drop any false results.
Check your balance any time with GET /api/v1/credits.
See every endpoint in the API reference.