Skip to main content
POST
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 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: Si se indican ambas, la búsqueda se hace con el nombre y la empresa.
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.
object
Un conjunto de ajustes relacionados con esta búsqueda

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

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.

Búsqueda a partir de una URL de perfil de LinkedIn

Envía la URL del perfil de LinkedIn de una persona en linkedin_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 indica linkedin_url y la solicitud no es una búsqueda completa por nombre y empresa:
  • fullname falta, está vacío o tiene un solo carácter, o
  • no se indica ni company_domain ni company_name.
Una solicitud con un 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?

Cualquier otro valor se rechaza con un 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 con no_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

La respuesta es la misma que en una búsqueda por nombre y empresa:

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.