Obtener resultado

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

const data = await response.json();
console.log(data);

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

GET

find

single

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

const data = await response.json();
console.log(data);

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

GET

https://api.enrow.io/email/find/single?id={id}

Recupera el resultado de una búsqueda de email lanzada previamente utilizando su ID único. Autentica cada solicitud con tu clave de API en el encabezado x-api-key.

Usar un webhook te permite omitir la llamada a este endpoint GET, ya que se te notificará en el momento en que finalice tu búsqueda. Consulta Cómo funcionan los webhooks.

Parámetros de consulta

string

requerido

El identificador único devuelto por la solicitud POST

Respuesta

200 — Búsqueda completada

string

La dirección de email descubierta

string

valid (email encontrado) o invalid (email no encontrado). ¿Por qué binario?

number

Costo final de la búsqueda, una vez aplicados los reembolsos: 1 por un email encontrado, 0 por un email no encontrado (0.25 para una búsqueda a partir de una URL de perfil de LinkedIn o para una cuenta con una tasa de éxito anormalmente baja, consulta Créditos y facturación). Una búsqueda a partir de una URL de perfil de LinkedIn que falla por un problema de nuestro lado cuesta 0: consulta Resultados de una búsqueda a partir de una URL de perfil de LinkedIn.

object

Información de contacto y de la empresa. En una búsqueda a partir de una URL de perfil de LinkedIn, solo está presente si se encuentra un email.

Mostrar propiedades de info

string

Dominio de la empresa

string

Nombre de la empresa

string

Nombre completo tal como se proporcionó en la solicitud

string

Nombre

string

Apellido

string

Género (male o female) — solo si retrieve_gender se estableció en true

object

Propiedades personalizadas enviadas en la solicitud original, devueltas tal cual

string

Solo en una búsqueda a partir de una URL de perfil de LinkedIn. Cómo terminó la búsqueda: found, profile_not_found, no_current_company, email_not_found o lookup_failed. Consulta Resultados de una búsqueda a partir de una URL de perfil de LinkedIn.

string

Solo en una búsqueda a partir de una URL de perfil de LinkedIn. El valor de linkedin_url que enviaste.

202 — Búsqueda aún en curso

string

ongoing — la búsqueda todavía no ha finalizado. Vuelve a consultar en breve o usa un webhook para recibir una notificación automática. Recuperar un resultado no consume créditos; consulta Créditos y facturación.

Respuestas de error

Código	Mensaje
400	`The single search id is missing in the URL query string`
500	`Could not retrieve single search results`

Consulta Gestión de errores para ver la lista completa de códigos de estado y formatos de respuesta.

Resultados de una búsqueda a partir de una URL de perfil de LinkedIn

Una búsqueda lanzada a partir de una URL de perfil de LinkedIn mantiene la qualification binaria y añade dos campos: linkedin_status, que indica cómo terminó la búsqueda, y linkedin_url, la URL que enviaste.

`linkedin_status`	Significado	`qualification`	`credits_used`
`found`	Se encontró y verificó el email profesional de la persona	`valid`	`1`
`profile_not_found`	No se encontró ningún perfil en esta URL de LinkedIn	`invalid`	`0.25`
`no_current_company`	El perfil no muestra ningún puesto actual en el que buscar	`invalid`	`0.25`
`email_not_found`	Perfil encontrado, pero ningún email en la empresa actual de la persona	`invalid`	`0.25`
`lookup_failed`	La búsqueda no se pudo completar por un problema de nuestro lado. Se reembolsa por completo: vuelve a intentarlo en unos minutos	`invalid`	`0`

Cuando se encuentra el email, info da el nombre y la empresa leídos en el perfil: firstname, lastname, company_name y company_domain, además de gender si retrieve_gender es true. En todos los demás casos, la respuesta no incluye ni email ni info: nunca revela a quién pertenece el perfil. Si el email o el perfil está en tu lista de supresión, el email encontrado no se devuelve: el resultado indica email_not_found y cuesta 1 crédito, como un email encontrado. Mientras la búsqueda está en curso, el endpoint devuelve el 202 habitual con qualification: "ongoing".

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "crm_id": "lead_001"
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "company_name": "Dunder Mifflin",
    "firstname": "Dwight",
    "lastname": "Schrute"
  },
  "linkedin_status": "found",
  "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
  "qualification": "valid",
  "credits_used": 1
}

{
  "custom": {
    "crm_id": "lead_001"
  },
  "linkedin_status": "no_current_company",
  "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
  "qualification": "invalid",
  "credits_used": 0.25
}

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

const data = await response.json();
console.log(data);

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

Próximos pasos

Encontrar un email

Lanza una búsqueda individual de email para obtener un id de búsqueda.