curl --request POST \
--url https://api.enrow.io/email/find/single \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": true
}
}'
const response = await fetch('https://api.enrow.io/email/find/single', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ENROW_API_KEY
},
body: JSON.stringify({
fullname: 'Dwight Schrute',
company_domain: 'dundermifflin.com',
settings: {
retrieve_gender: true
}
})
});
const data = await response.json();
console.log(data.id);
import requests
import os
url = "https://api.enrow.io/email/find/single"
headers = {
"Content-Type": "application/json",
"x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": True
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"message": "Single search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 1
}
{
"message": "..."
}
Email Finder
Buscar email
Encuentra una dirección de email profesional a partir de un nombre completo y el dominio o nombre de la empresa, o a partir de una URL de perfil de LinkedIn
POST
/
email
/
find
/
single
curl --request POST \
--url https://api.enrow.io/email/find/single \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": true
}
}'
const response = await fetch('https://api.enrow.io/email/find/single', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ENROW_API_KEY
},
body: JSON.stringify({
fullname: 'Dwight Schrute',
company_domain: 'dundermifflin.com',
settings: {
retrieve_gender: true
}
})
});
const data = await response.json();
console.log(data.id);
import requests
import os
url = "https://api.enrow.io/email/find/single"
headers = {
"Content-Type": "application/json",
"x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": True
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"message": "Single search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 1
}
{
"message": "..."
}
POST
Ejecuta una búsqueda de email individual para encontrar una dirección de email profesional. Autentica cada solicitud con tu clave de API en la cabecera
Consulta Gestión de errores para ver la lista completa de códigos de estado y formatos de respuesta.
Cualquier otro valor se rechaza con un
La respuesta es la misma que en una búsqueda por nombre y empresa:
https://api.enrow.io/email/find/single
x-api-key. Para operaciones por lotes, usa el endpoint Buscar emails (hasta 5.000 búsquedas por lote).
La búsqueda necesita una de estas dos opciones:
- Un nombre completo y una empresa:
fullname+ (company_domainocompany_name) - La URL del perfil de LinkedIn de una persona en
linkedin_url(consulta Búsqueda a partir de una URL de perfil de LinkedIn)
Enrow realiza verificaciones deterministas que verifican incluso los emails catch-all. Esto significa que no es necesario pasar después los emails encontrados por un debouncer.
Cuerpo de la solicitud
string
El nombre completo de la persona cuyo email se quiere encontrarNota: Se requiere para una búsqueda por nombre y empresa, no para una búsqueda a partir de
linkedin_url.string
El dominio de la empresa, se aceptan varios formatos (
"dundermifflin.com", "https://www.dundermifflin.com"…)Nota: Se requiere company_domain o company_name para una búsqueda por nombre y empresa.string
El nombre de la empresa (
"Apple", "Air France", …)Nota: Se requiere company_domain o company_name para una búsqueda por nombre y empresa.string
La URL del perfil de LinkedIn de la persona (
"https://www.linkedin.com/in/dwight-schrute"), para buscar a partir del perfil en lugar de un nombre y una empresa. Consulta Búsqueda a partir de una URL de perfil de LinkedIn.Nota: Solo se usa cuando la solicitud no es una búsqueda completa por nombre y empresa. Con un fullname y una empresa, se ignora linkedin_url.object
Parámetros personalizados que se devolverán en la respuesta GET y en la notificación del webhook.
Mostrar objeto custom
Mostrar objeto custom
string
predeterminado:"your_custom_property"
Tus datos personalizados
object
Un conjunto de ajustes relacionados con esta búsqueda
Mostrar propiedades de settings
Mostrar propiedades de settings
string
Una URL que será notificada mediante una solicitud HTTP POST una vez finalizada la búsqueda individual. Consulta Cómo funcionan los webhooks.
string
predeterminado:"US"
El código ISO 3166 Alpha-2 del país relacionado con la búsqueda. Es relevante al usar un nombre de empresa: ayuda a desambiguar homónimos buscando en el Google localizado.
boolean
predeterminado:"false"
Te permite obtener el género (
male/female) de la persona.Respuesta
200 — Búsqueda iniciada
string
Mensaje de confirmación
string
Identificador único de esta búsqueda. Úsalo para recuperar los resultados mediante el endpoint GET.
number
Número de créditos consumidos. Consulta Créditos y facturación para conocer los costes por endpoint.
Respuestas de error
| Código | Mensaje |
|---|---|
| 400 | invalid JSON input |
| 400 | both company_domain and company_name are absent, input payload needs at least one of them |
| 400 | missing fullname |
| 400 | invalid linkedin_url format |
| 400 | LinkedIn email search is suspended for this account |
| 401 | No apikey found in the x-api-key headers |
| 401 | This apikey is not valid |
| 402 | Insufficient credits |
Las respuestas por créditos insuficientes (
402) en los endpoints individuales devuelven { "reason": "...", "success": false }; todos los demás errores devuelven { "message": "..." }.Búsqueda a partir de una URL de perfil de LinkedIn
Envía la URL del perfil de LinkedIn de una persona enlinkedin_url en lugar de un nombre completo y una empresa. Enrow lee el perfil, identifica la empresa actual de la persona y después encuentra y verifica allí su email profesional.
La búsqueda funciona como cualquier otra búsqueda individual: la respuesta 200 te da su id, y el resultado llega a través del endpoint GET o de tu webhook. custom y settings funcionan igual.
La búsqueda a partir de una URL de perfil de LinkedIn solo funciona en búsquedas individuales y puede que no esté disponible en todas las cuentas. Si tu cuenta no la tiene, una solicitud que solo incluya
linkedin_url recibe el error de validación habitual, como missing fullname. Escribe a api@enrow.io si la necesitas.¿Cuándo usa la búsqueda el perfil?
La búsqueda parte del perfil cuando se indicalinkedin_url y la solicitud no es una búsqueda completa por nombre y empresa:
fullnamefalta, está vacío o tiene un solo carácter, o- no se indica ni
company_domainnicompany_name.
fullname y una empresa sigue siendo una búsqueda por nombre y empresa, aunque incluya linkedin_url. Cuando la búsqueda parte del perfil, el nombre y la empresa salen del perfil: se ignora cualquier fullname, company_domain o company_name que se envíe además.
¿Qué URL se aceptan?
| Formato | Ejemplo |
|---|---|
| URL de perfil público | https://www.linkedin.com/in/dwight-schrute |
Sin https:// ni www., con barra final o con parámetros de consulta | linkedin.com/in/dwight-schrute/?trk=people-guest |
| Subdominio de país | https://fr.linkedin.com/in/dwight-schrute |
| URL de perfil con un ID de miembro | https://www.linkedin.com/in/ACoAAB2xY3ZaBcD |
| URL de Sales Navigator de tipo lead o people | https://www.linkedin.com/sales/lead/ACwAAB2xY3ZaBcD,NAME_SEARCH,a1b2 |
400 y el mensaje invalid linkedin_url format: una página de empresa (linkedin.com/company/...), un enlace corto lnkd.in, una página fuera de linkedin.com o un nombre de perfil sin la URL.
¿Cómo elige Enrow la empresa?
Enrow busca el email en la empresa actual de la persona, tal como aparece en el perfil. Si hay varios puestos actuales, toma el primero de la lista. Las entradas que no corresponden a un empleador, como autónomo, freelance o estudiante, se omiten. Si el perfil no muestra ningún puesto actual con un empleador, la búsqueda termina conno_current_company.
¿Cuánto cuesta?
Lanzar la búsqueda consume 1 crédito, como cualquier búsqueda (credits_used: 1 en la respuesta). Cuando termina, se reembolsa la diferencia: la búsqueda cuesta 1 crédito si se encuentra un email, 0,25 créditos si no se encuentra ninguno y nada si falla por un problema de nuestro lado. El resultado indica el motivo en linkedin_status y el costo final en credits_used. Consulta Créditos y facturación.
Ejemplo
curl --request POST \
--url https://api.enrow.io/email/find/single \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
"linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
"custom": {
"crm_id": "lead_001"
}
}'
const response = await fetch('https://api.enrow.io/email/find/single', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ENROW_API_KEY
},
body: JSON.stringify({
linkedin_url: 'https://www.linkedin.com/in/dwight-schrute',
custom: {
crm_id: 'lead_001'
}
})
});
const data = await response.json();
console.log(data.id);
import requests
import os
url = "https://api.enrow.io/email/find/single"
headers = {
"Content-Type": "application/json",
"x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
"linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
"custom": {
"crm_id": "lead_001"
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"message": "Single search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 1
}
curl --request POST \
--url https://api.enrow.io/email/find/single \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": true
}
}'
const response = await fetch('https://api.enrow.io/email/find/single', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ENROW_API_KEY
},
body: JSON.stringify({
fullname: 'Dwight Schrute',
company_domain: 'dundermifflin.com',
settings: {
retrieve_gender: true
}
})
});
const data = await response.json();
console.log(data.id);
import requests
import os
url = "https://api.enrow.io/email/find/single"
headers = {
"Content-Type": "application/json",
"x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": True
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"message": "Single search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 1
}
{
"message": "..."
}
Próximos pasos
Obtener el resultado
Recupera el email encontrado usando el
id de la búsqueda.Buscar emails por lotes
Ejecuta hasta 5.000 búsquedas de email en una sola solicitud.
Autenticación
Cómo pasar tu clave de API en la cabecera x-api-key.
Webhooks
Recibe una notificación automática cuando una búsqueda finaliza.
¿Esta página le ayudó?

