Email Finding Icypeas API
Find a professional email from a person and company through the durable Request lifecycle.
Pricing
Email Finding Icypeas API pricing
Call it
Get Email Finding icypeas in one request
import os, requests res = requests.post( "https://api.getanyapi.com/v1/run/email_finding.icypeas", headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"}, json={ "domainOrCompany": "" }, ) print(res.json())
{
"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,
"reason": "not_found"
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-11-05 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- domainOrCompanystring
apollo.io
- firstnamestring
Tim
- lastnamestring
Zheng
Response
JSON, one example value per field.
The matched person and email, or null when nothing was found.
- certaintystring
Confidence label for the best matching address, e.g. ultra_sure.
- createdUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- emailstring
Best matching email address.
- firstnamestring
Matched first name.
- fullnamestring
Matched full name.
- genderstring
Gender recorded for the matched person. Absent when the source does not know it.
- lastnamestring
Matched last name.
- linkedinUrlstring
LinkedIn profile URL for the matched person, when the source has one.
- modifiedUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- mxProviderstring
Mail provider behind the domain, e.g. google.
- mxRecordsstring[]
Mail exchange records for the domain.
- phonesany
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.
- saasServicesany
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.
- scanIdstring
Icypeas' identifier for the search that produced this result.
- scanNamestring
Icypeas' internal label for the kind of search that ran, e.g. __icypeas__individual.
- scanOrderinteger
Position of this result inside the Icypeas search batch. It is 0 for the single-person search this SKU runs.
- scanStatusstring
Icypeas' terminal status for the search, FOUND or NOT_FOUND. It duplicates the envelope's found flag.
- scanUserstring
Icypeas account that ran the search.
Every candidate address found for the person, best first. The top-level email is the first entry.
- certaintystring
Confidence label for this address, e.g. ultra_sure.
- emailstring
Candidate email address.
- mxProviderstring
Mail provider behind this address's domain.
- mxRecordsstring[]
Mail exchange records for this address's domain.
- foundboolean
False when no email was found for the person.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
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, 99.9% of Email Finding icypeas calls through AnyAPI succeeded across 7,352 measured calls.