API para Email Finding
API para Email Finding: Icypeas
Encontre um e-mail profissional a partir de uma pessoa e de uma empresa pelo ciclo de vida durável da requisição.
POST/v1/run/email_finding.icypeas
Requisições
-
30d
Preços
Um preço, em dólares
Como chamar
Faça sua primeira requisição
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())
Resposta de exemplo
{
"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"
}Interface da resposta
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;
reason?: "not_found";
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Requisição, resposta e preço
Última verificação em 2026-09-29 · disponibilidade e latência medidas em 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"}'| Campo | Tipo | Valor de exemplo |
|---|---|---|
| Corpo da requisição | ||
| domainOrCompany | string | "apollo.io" |
| firstname | string | "Tim" |
| lastname | string | "Zheng" |
| Resposta | ||
| 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. |
| 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. |
| Preço | ||
| Preço por requisição | USD | US$ 0,0168 |
| Preço /mil req. | USD | US$ 16,80 |
Dúvidas frequentes
Sobre o endpoint Icypeas da API para Email Finding
O endpoint Icypeas da AnyAPI para Email Finding retorna dados de Email Finding em JSON normalizado com uma chamada POST para /v1/run/email_finding.icypeas. Encontre um e-mail profissional a partir de uma pessoa e de uma empresa pelo ciclo de vida durável da requisição. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 16,80 por mil requisições, em dólares, sem assinatura e sem mínimo mensal.
Custa a partir de US$ 16,80 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.
Encontre um e-mail profissional a partir de uma pessoa e de uma empresa pelo ciclo de vida durável da requisição. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.
Mais para chamar