Saltar al contenido principal
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
    }
  }'
{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}
POST
https://api.enrow.io/email/find/single
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 x-api-key. Para operaciones por lotes, usa el endpoint Buscar emails (hasta 5.000 búsquedas por lote).
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

fullname
string
requerido
El nombre completo de la persona cuyo email se quiere encontrar
company_domain
string
El dominio de la empresa, se aceptan varios formatos ("dundermifflin.com", "https://www.dundermifflin.com"…)Nota: Se requiere company_domain o company_name.
company_name
string
El nombre de la empresa ("Apple", "Air France", …)Nota: Se requiere company_domain o company_name.
custom
object
Parámetros personalizados que se devolverán en la respuesta GET y en la notificación del webhook.
settings
object
Un conjunto de ajustes relacionados con esta búsqueda

Respuesta

200 — Búsqueda iniciada

message
string
Mensaje de confirmación
id
string
Identificador único de esta búsqueda. Úsalo para recuperar los resultados mediante el endpoint GET.
credits_used
number
Número de créditos consumidos. Consulta Créditos y facturación para conocer los costes por endpoint.

Respuestas de error

CódigoMensaje
400invalid JSON input
400both company_domain and company_name are absent, input payload needs at least one of them
400missing fullname
401No apikey found in the x-api-key headers
401This apikey is not valid
402Insufficient credits
Las respuestas por créditos insuficientes (402) en los endpoints individuales devuelven { "reason": "...", "success": false }; todos los demás errores devuelven { "message": "..." }.
Consulta Gestión de errores para ver la lista completa de códigos de estado y formatos de respuesta.
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
    }
  }'
{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

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.