An email finder API takes a person's first name, last name, and company domain, then returns their most likely verified work email. The verification step happens at discovery time, so you get an address you can send to, not just a guess you have to check separately. Our free email finder and validator does this in the browser with no account required. The email finder API exposes the same engine over HTTP so you can embed it in any automation workflow, AI agent, or GTM stack.
StartupHub.ai indexes more than 84,000 startups globally, and programmatic email discovery is now one of the most common capabilities built into the GTM automation workflows running on top of that data: every modern outbound stack treats contact discovery as infrastructure, not an optional lookup.
How the Email Finder API Works
The discovery endpoint checks the target domain's email format pattern, constructs candidates from the most common permutations of the person's name, and runs live SMTP verification on each candidate before returning a result. The response includes the confirmed address, a confidence score, the detected domain pattern, and full deliverability status. Your application never has to call a second endpoint to check what was found.
Request: GET /api/v1/email/discover with three parameters: first_name, last_name, and domain. Authenticate with your API key in the Authorization header. Get a free key in under 30 seconds at the API docs page.
Quick Start: Three Ways to Call the Finder API
cURL
curl -s \
"https://www.startuphub.ai/api/v1/email/discover?first_name=Jane&last_name=Smith&domain=acmecorp.com" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import requests
resp = requests.get(
"https://www.startuphub.ai/api/v1/email/discover",
params={
"first_name": "Jane",
"last_name": "Smith",
"domain": "acmecorp.com"
},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = resp.json()
print(data["email"], data["status"], data["score"])
JavaScript (fetch)
const params = new URLSearchParams({
first_name: "Jane",
last_name: "Smith",
domain: "acmecorp.com"
});
const response = await fetch(
`https://www.startuphub.ai/api/v1/email/discover?${params}`,
{ headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const result = await response.json();
if (result.status === "valid") {
console.log(result.email, result.score); // verified, safe to send
} else if (result.status === "catch_all") {
// inconclusive: flag for manual review
} else {
// address could not be confirmed
}
Response Fields Explained
A successful response returns a JSON object with these fields:
