Cómo enriquecer tus datos mediante la API de Snov.io

Esta guía explica cómo enviar tus datos para enriquecerlos y obtener valiosa información B2B a través de la API de Snov.io.

Cómo utilizar la API de enriquecimiento de datos de Snov.io:

- Automatiza la generación de leads y verifica correos empresariales
- Amplía tus bases de datos actuales con nuevos puntos de información
- Mejora tu aplicación integrando nuestros datos
- Incorpora las herramientas de Snov.io a tus flujos de trabajo existentes

Cómo funciona el enriquecimiento de datos:

Envía los datos que ya tienes a Snov.io mediante una solicitud API. Nosotros los comparamos con nuestra base de datos o buscamos la información por ti. A cambio, recibes los datos enriquecidos.

Este proceso mejora automáticamente tu información existente con datos actualizados de ventas. Usar la API te permite escalar esta operación, ya sea que necesites enriquecer 10 registros o 10.000.

Tipos de enriquecimiento disponibles en Snov.io:

• Encontrar dominios a partir de nombres de empresa
• Find email addresses from names and domains
• Verify email status
• Get complete data from LinkedIn profile links

Encontrar dominios a partir de nombres de empresa

Usando la API de Enriquecimiento de Nombres de Dominio, puedes obtener el dominio (sitio web) de una empresa proporcionando su nombre oficial exacto.

Cómo funciona:

1. Envía los nombres de empresa a la API.
2. Recibe los dominios correspondientes.

Para encontrar correos y prospectos desde un dominio, utiliza la API Domain Search.

Paso 1: Envía tus datos (nombres de empresas)

Request’s URL: https://api.snov.io/v2/company-domain-by-name/start

Request’s type: POST

Parámetro `names[]`: ingresa el nombre de la empresa.
Puedes enriquecer hasta 10 empresas por solicitud, cada una en su propio parámetro:

Para recibir los resultados automáticamente, añade el parámetro `webhook_url` con la URL donde deseas recibir los datos enriquecidos.

También puedes obtener automáticamente información sobre otros eventos en tu cuenta. Consulta la lista completa de *webhooks* [aquí]

Usar el *webhook* es opcional. Si decides omitirlo, puedes recuperar los resultados mediante una solicitud API por separado.

La respuesta proporcionará un `"task_hash"`: un identificador único para tu solicitud. Necesitarás este ID para obtener tus resultados mediante una solicitud de API posterior.

Paso 2. Obtener resultados (recibir dominios de empresas)

Hay dos maneras de recibir tus datos enriquecidos:

1. Webhook: Si agregaste un *webhook* a la solicitud anterior, te enviaremos los resultados allí cuando estén listos.
2. Solicitud API separada: Utiliza la siguiente solicitud:

Tipo de solicitud: GET

URL: https://api.snov.io/v2/company-domain-by-name/result?task_hash={hash_from_1}

En el parámetro `"task_hash"`, añade el ID único de tu solicitud anterior, donde enviaste los datos.

Por cada empresa que solicitaste, la API de Snov.io devolverá los siguientes campos:

• "name": El nombre original de la empresa que proporcionaste
  
• "domain": La dirección del dominio de la empresa

Para más detalles, consulta los ejemplos de solicitud y respuesta en nuestra [documentación API]

Encontrar direcciones de correo electrónico a partir de nombres y dominios

Con la API Localizador de Email, puedes encontrar direcciones de correo electrónico empresariales verificadas proporcionando el nombre del prospecto y el dominio de su empresa.

Cómo funciona:

1. Envía el nombre, apellido y el dominio de la empresa del prospecto a la API.
2. Recibe a cambio la dirección de correo electrónico y el estado de verificación

Paso 1. Enviar tus datos (nombre y dominio)

Tipo de solicitud: POST

URL: https://api.snov.io/v2/emails-by-domain-by-name/start

En el parámetro `"rows"`, proporciona la información del prospecto: nombre, apellido y dominio.

La API permite búsqueda masiva. Puedes enriquecer hasta **10 prospectos por solicitud**. Verificaremos y encontraremos el correo electrónico del prospecto. La verificación en múltiples pasos asegura correos empresariales precisos.

Cada prospecto debe incluir un arreglo de datos con estos campos:

En los campos "first_name" y "last_name", proporciona el nombre y apellido del prospecto.

En el campo "domain", indica el nombre de dominio de la empresa para la que trabaja el prospecto.

Para recibir los resultados automáticamente, añade el parámetro `"webhook_url"` con la URL de destino donde deseas recibir los resultados. Usar *webhook* es opcional. Si lo omites, puedes recuperar los resultados con una solicitud API separada.

La respuesta devolverá un `"task_hash"` que necesitarás para obtener los resultados.

Paso 2. Obtener resultados (correo electrónico verificado)

Hay dos maneras de obtener resultados:

1. Webhook: Si agregaste un *webhook* a la solicitud anterior, enviaremos los resultados cuando estén listos.
2. Solicitud API separada:

Tipo de solicitud: GET

URL: https://api.snov.io/v2/emails-by-domain-by-name/start/result?task_hash={hash_from_1}

En el parámetro `"task_hash"` agrega el ID único recibido anteriormente.

Por cada prospecto, Snov.io devolverá:

• Dirección de correo electrónico
• Estado de verificación (`valid`, `invalid` o `unknown`)
• Resultados de verificaciones adicionales que confirman o explican el estado

Consulta nuestra documentación API para más detalles.

Verificar el estado de correos electrónicos

Con la API Verificador de Email, puedes comprobar si tus direcciones de correo electrónico son válidas. Esto asegura que tu lista de correos esté libre de riesgos de entregabilidad.

Cómo funciona:

1. Proporciona las direcciones de correo electrónico a verificar.
2. Recibe los estados de verificación correspondientes.

Paso 1. Enviar tus datos (correos a verificar)

Tipo de solicitud: POST

URL: https://api.snov.io/v2/email-verification/start

En el parámetro `"emails[]"`, incluye las direcciones de correo que deseas verificar (hasta 10 por solicitud).

Para recibir los resultados automáticamente, añade `"webhook_url"` con tu URL de destino. Es opcional; puedes hacer una solicitud separada si lo prefieres.

La respuesta devolverá un `"task_hash"` que usarás para consultar los resultados.

Paso 2. Obtener resultados (estado del correo electrónico)

Dos formas de recibir los resultados:

1. Webhook: Si has agregado un webhook a la solicitud anterior, enviaremos los resultados allí cuando estén listos.
2. Solicitud API: Usa la siguiente solicitud.

Tipo de solicitud: GET

URL: https://api.snov.io/v2/email-verification/result?task_hash={hash_from_1}'

En el parámetro `"task_hash"`, agrega el ID único recibido de tu solicitud anterior donde enviaste los datos.

Para cada dirección de correo electrónico que agregaste para verificación, Snov.io comprobará y devolverá uno de estos tres estados:

• valid: La dirección de correo existe y puede recibir mensajes
  
• not_valid: El correo no existe o no puede recibir mensajes
• unknown (Unverifiable): No se pudo verificar con un 100% de certeza, pero es probable que sea válida.
  

Para los correos con estado "unknown" (desconocido), proporcionamos una razón detallada determinada durante la verificación. Podría ser una de las siguientes:

Banned: Alto riesgo de entrega — la dirección no pudo verificarse con total certeza.
Catchall: Riesgo para la reputación del remitente — el servidor de correo utiliza una política "catch-all", lo que impide confirmar si el correo existe.
Connection error: Alto riesgo de rebote por problemas técnicos en el servidor del destinatario.
Greylisted: El servidor usa filtros de lista gris, lo que dificulta la verificación del correo.
Hidden by owner: El propietario del correo o la empresa dueña del dominio solicitó su eliminación de los resultados de Snov.io.

Consulta la lista completa de campos enriquecidos en la documentación de la API.

Obtener datos completos a partir de enlaces de perfiles de LinkedIn

Con la función de enriquecimiento de perfiles de LinkedIn, puedes obtener información sobre un prospecto proporcionando el enlace a su perfil.

¿Cómo funciona?

1. Proporciona la URL del perfil de LinkedIn a la API.
2. Recibe detalles completos del prospecto, como su cargo y otra información.

Paso 1. Envía tus datos (proporciona URLs de LinkedIn)

Tipo de solicitud: POST

URL: https://api.snov.io/v2/li-profiles-by-urls/start

En el parámetro `"urls[]"`, añade las URLs de LinkedIn para las que deseas obtener información. Puedes agregar hasta 10 URLs por solicitud. Cada URL debe ir en un parámetro separado.

Para recibir los resultados automáticamente, añade el parámetro `"webhook_url"` con la URL de destino donde Snov.io enviará los datos enriquecidos. Usar el webhook es opcional. Si lo omites, puedes recuperar los resultados con una solicitud API separada.

La respuesta de esta solicitud proporcionará un `"task_hash"`: un identificador único para tu solicitud. Necesitarás este ID para obtener los resultados en una solicitud de seguimiento.

Paso 2. Obtener resultados (recibir información del perfil del prospecto)

Hay dos formas de recibir tus datos enriquecidos:

1. Webhook: Si agregaste un webhook a la solicitud anterior, enviaremos los resultados allí cuando estén listos.
2. Solicitud API separada: Usa la siguiente solicitud.

Tipo de solicitud: GET

URL: https://api.snov.io/v2/li-profiles-by-urls/result?task_hash={hash_from_1}

En el parámetro `"task_hash"`, agrega el ID único de tu solicitud anterior.

Para cada enlace de perfil de LinkedIn que agregaste, Snov.io devolverá los datos completos del prospecto y de su empresa.

Datos del prospecto:

• Nombre completo, nombre, apellido
• Industria
• País y ciudad
• Cargo

Datos de la empresa:

•  Nombre de la empresa
• URL de LinkedIn de la empresa
• Dominio de la empresa
• Industria
• País y ciudad

Consulta los ejemplos de solicitud y respuesta en nuestra documentación de API para más detalles.

Costo en créditos del uso de la API de enriquecimiento de datos

En la siguiente tabla, te mostramos cómo Snov.io descuenta créditos de tu saldo al usar las solicitudes de enriquecimiento, Localizador y Verificador de Email.

Los créditos solo se descuentan por solicitudes exitosas. Si no se encuentran resultados y no se devuelve información en la respuesta, no se cobrará ningún crédito.