Email Finding API
Email Finding Icypeas API
Find a professional email from a person and company through the durable Request lifecycle.
POST/v1/run/email_finding.icypeas
Uptime
100.00%
30d · 48 calls
Requests
61
30d · weekly, last 12 wks
Response
0.0s
median · 30d
Try it
Make your first request
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
"data": {
"certainty": "example",
"createdUtc": 12.5,
"email": "alex@example.com",
"emails": [
{
"certainty": "example",
"email": "alex@example.com",
"mxProvider": "a1b2c3d4",
"mxRecords": [
"example"
]
}
],
"firstname": "Alex",
"fullname": "Alex Rivera",
"gender": "example",
"lastname": "Rivera",
"linkedinUrl": "https://example.com/page",
"modifiedUtc": 12.5,
"mxProvider": "a1b2c3d4",
"mxRecords": [
"example"
],
"phones": null,
"saasServices": null,
"scanId": "a1b2c3d4",
"scanName": "Example title",
"scanOrder": 1,
"scanStatus": "active",
"scanUser": "example"
},
"found": true
}Response interface
interface EmailFindingIcypeasResponse {
data: {
certainty?: string;
createdUtc?: number;
email: string;
emails?: {
certainty?: string;
email?: string;
mxProvider?: string;
mxRecords?: string[];
}[];
firstname?: string;
fullname?: string;
gender?: string;
lastname?: string;
linkedinUrl?: string;
modifiedUtc?: number;
mxProvider?: string;
mxRecords?: string[];
phones?: any;
saasServices?: any;
scanId?: string;
scanName?: string;
scanOrder?: number;
scanStatus?: string;
scanUser?: string;
} | null;
found: boolean;
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
Request, response, and price
Last verified 2026-09-16 · uptime and latency measured over 30dPOST /v1/run/email_finding.icypeas
curl -X POST https://api.getanyapi.com/v1/run/email_finding.icypeas \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"domainOrCompany":"apollo.io","firstname":"Tim","lastname":"Zheng"}'| Field | Type | Example value |
|---|---|---|
| Request body | ||
| domainOrCompany | string | "apollo.io" |
| firstname | string | "Tim" |
| lastname | string | "Zheng" |
| Response | ||
| data | object | The matched person and email, or null when nothing was found. |
| data.certainty | string | Confidence label for the best matching address, e.g. ultra_sure. |
| data.createdUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. |
| data.email | string | Best matching email address. |
| data.emails | object[] | Every candidate address found for the person, best first. The top-level email is the first entry. |
| data.emails[].certainty | string | Confidence label for this address, e.g. ultra_sure. |
| data.emails[].email | string | Candidate email address. |
| data.emails[].mxProvider | string | Mail provider behind this address's domain. |
| data.emails[].mxRecords | string[] | Mail exchange records for this address's domain. |
| data.firstname | string | Matched first name. |
| data.fullname | string | Matched full name. |
| data.gender | string | Gender recorded for the matched person. Absent when the source does not know it. |
| data.lastname | string | Matched last name. |
| data.linkedinUrl | string | LinkedIn profile URL for the matched person, when the source has one. |
| data.modifiedUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. |
| data.mxProvider | string | Mail provider behind the domain, e.g. google. |
| data.mxRecords | string[] | Mail exchange records for the domain. |
| data.phones | any | Phone numbers Icypeas returned alongside the address. Deliberately untyped: the field is empty in every response we have captured, so the value passes through without a shape guarantee. |
| data.saasServices | any | SaaS services Icypeas associates with the person. Deliberately untyped: the field is empty in every response we have captured, so the value passes through without a shape guarantee. |
| data.scanId | string | Icypeas' identifier for the search that produced this result. |
| data.scanName | string | Icypeas' internal label for the kind of search that ran, e.g. __icypeas__individual. |
| data.scanOrder | integer | Position of this result inside the Icypeas search batch. It is 0 for the single-person search this SKU runs. |
| data.scanStatus | string | Icypeas' terminal status for the search, FOUND or NOT_FOUND. It duplicates the envelope's found flag. |
| data.scanUser | string | Icypeas account that ran the search. |
| found | boolean | False when no email was found for the person. |
| Price | ||
| Price per request | USD | $0.0168 |
| Price /1k req | USD | $16.80 |
FAQ
About the Email Finding Icypeas API
The AnyAPI Email Finding Icypeas API returns Email Finding icypeas data as normalized JSON from one POST call to /v1/run/email_finding.icypeas. Find a professional email from a person and company through the durable Request lifecycle. AnyAPI returns one normalized schema whichever source serves it. It costs from $16.80 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Email Finding icypeas calls through AnyAPI succeeded across 48 measured calls.
It costs from $16.80 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.
Find a professional email from a person and company through the durable Request lifecycle. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.
Over the last 30 days, 100.0% of Email Finding icypeas calls through AnyAPI succeeded across 48 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.