Inicio  /  Integraciones & APIs  /  REST API  /  

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

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

nota

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

- Automatiza el proceso de captación de leads y verifica correos electrónicos empresariales

- Amplía tus conjuntos de datos actuales con información adicional

- Enriquece tu app con nuestros datos

- Integra las herramientas de Snov.io en tus flujos de trabajo actuales

Cómo funciona el Enriquecimiento de datos:

Envía los datos que tienes a Snov.io mediante una solicitud a la API. Comparamos tu información con nuestra base de datos o buscamos los datos que necesitas. Después, te devolvemos la información enriquecida.

Este proceso amplía automáticamente la información que ya tienes con datos comerciales actualizados. La API permite hacerlo a gran escala, tanto si necesitas enriquecer 10 registros como 10 000.

¿Qué opciones de Enriquecimiento de datos ofrece Snov.io?

 

Encontrar dominios a partir de nombres de empresas

Con el Enriquecimiento de dominios, puedes encontrar el dominio (sitio web) de una empresa proporcionando su nombre oficial exacto.

Cómo funciona:

1) Envía los nombres de las empresas a la API.

2) Recibe los dominios correspondientes.

información
Para encontrar correos electrónicos y prospectos a partir de dominios, utiliza la API de Búsqueda de dominios.

Paso 1. Envía tus datos (proporciona los nombres de las empresas)

URL de la solicitud: https://api.snov.io/v2/company-domain-by-name/start

Tipo de solicitud: POST

En el parámetro “names[]” , introduce el nombre de la empresa cuyo dominio quieres obtener.

Puedes enriquecer hasta 10 empresas por solicitud. Añade cada nombre de empresa en un parámetro independiente.

names[]: company_1

names[]: company_2

Para recibir los resultados automáticamente, añade el parámetro "webhook_url" con la URL de destino a la que Snov.io enviará los datos enriquecidos.

información
También puedes recibir automáticamente información sobre otros eventos de tu cuenta. Consulta aquí la lista completa de webhooks. 

El uso del webhook es opcional. Si no lo configuras, puedes recuperar los resultados mediante otra solicitud a la API.

La respuesta incluirá un "task_hash": un identificador único de tu solicitud. Necesitarás este ID para obtener los resultados mediante una solicitud posterior a la API.

Paso 2. Obtén los resultados (recibe los dominios de las empresas)

Hay dos formas de recibir los datos enriquecidos:

  1. Webhook: Si añadiste un webhook en la solicitud anterior, enviaremos los resultados allí cuando estén listos.
  2. Solicitud independiente a la API: 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", introduce el identificador único de la solicitud anterior en la que enviaste los datos.

Por cada empresa incluida en tu solicitud, 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 obtener más detalles, consulta los ejemplos de solicitudes y respuestas en nuestra documentación de la API.

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

Con la API del Buscador de correos electrónicos, puedes encontrar direcciones de correo electrónico empresariales verificadas si proporcionas el nombre de un prospecto y el dominio de su empresa.

Cómo funciona:

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

Paso 1. Envía tus datos (proporciona el nombre y el dominio)

Tipo de solicitud: POST

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

En el parámetro “rows”, proporciona los datos del prospecto: nombre, apellido y dominio.

nota
La API del Buscador de correos electrónicos admite búsquedas masivas. Puedes enriquecer hasta 10 prospectos en una sola solicitud a la API. Buscaremos y verificaremos la dirección de correo electrónico de cada prospecto. El proceso de verificación de varios pasos garantiza que recibas correos electrónicos empresariales precisos.

Para cada prospecto incluido en tu solicitud, añade un conjunto de datos con los siguientes campos:

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

En el campo "domain", introduce el dominio de la empresa en la que trabaja el prospecto.

"first_name": nombre del prospecto
"last_name": apellido del prospecto
"domain": sitio web de la empresa

información
Para recibir los resultados de la búsqueda automáticamente, añade el parámetro "webhook_url" con la URL de destino a la que Snov.io los enviará. El uso del webhook es opcional. Si no lo configuras, puedes recuperar los resultados mediante otra solicitud a la API.

La respuesta incluirá un "task_hash": un identificador único de tu solicitud. Necesitarás este ID para obtener los resultados al enviar una solicitud posterior a la API.

Paso 2. Obtén los resultados (recibe una dirección de correo electrónico verificada)

Hay dos formas de obtener los resultados:

  1. Webhook: Si añadiste un webhook en la solicitud anterior, enviaremos los resultados allí cuando termine la búsqueda.
  2. Solicitud independiente a la API:

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" de esta solicitud, introduce el identificador único que recibiste en la solicitud anterior, en la que enviaste los datos.

Por cada prospecto incluido en tu solicitud, Snov.io devolverá los siguientes datos:

  • La dirección de correo electrónico
  • El estado de verificación (válido, no válido o desconocido)
  • Los resultados de comprobaciones adicionales que confirman la validez o explican por qué el estado es desconocido

Para obtener más detalles, consulta nuestra documentación de la API.

Verificar el estado de los correos electrónicos

Con la API del Verificador de correos electrónicos, puedes comprobar si tus direcciones de correo electrónico son válidas. Nuestro Verificador de correos electrónicos confirma que tu lista no presenta riesgos para la entregabilidad y está lista para utilizarse en campañas.

Cómo utilizarlo:

  1. Proporciona a la API las direcciones de correo electrónico que quieres verificar.
  2. Recibe los estados de verificación de esas direcciones.

Paso 1. Envía tus datos (proporciona las direcciones de correo electrónico que quieres verificar)

Tipo de solicitud: POST

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

En el parámetro "emails[]", introduce las direcciones de correo electrónico cuyo estado quieres comprobar.

Puedes comprobar hasta 10 direcciones por solicitud. Añade cada dirección de correo electrónico en un parámetro independiente.

emails[]: dirección_de_correo_1

emails[]: dirección_de_correo_2

emails[]: dirección_de_correo_3

Para recibir los resultados de la verificación automáticamente, añade el parámetro "webhook_url" con la URL de destino a la que Snov.io los enviará. El uso del webhook es opcional. Si no lo configuras, puedes recuperar los resultados mediante otra solicitud a la API.

La respuesta incluirá un "task_hash": un identificador único de tu solicitud. Necesitarás este ID para recuperar los resultados mediante una solicitud posterior a la API.

Paso 2. Obtén los resultados (recibe el estado de los correos electrónicos)

Hay dos formas de recibir los datos enriquecidos:

  1. Webhook: Si añadiste un webhook en la solicitud anterior, enviaremos los resultados allí cuando estén listos.
  2. Solicitud a la API: Utiliza 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", introduce el identificador único que recibiste en la solicitud anterior, en la que enviaste los datos.

Snov.io comprobará cada dirección de correo electrónico que hayas enviado para verificar y devolverá uno de estos tres estados:

  • valid: la dirección de correo electrónico existe y puede recibir mensajes
  • not_valid: la dirección no existe o no puede recibir mensajes
  • unknown (Unverifiable): no fue posible verificar la dirección con total certeza, aunque es probable que sea válida.

Para las direcciones con estado "unknown", proporcionamos una explicación detallada del motivo detectado durante la verificación. Puede ser uno de los siguientes:

Banned (Bloqueado): riesgo alto para la entregabilidad; no fue posible verificar la dirección con total certeza.

Catchall: riesgo para la reputación del remitente; el servidor de correo utiliza una política "catch-all", por lo que no es posible confirmar si la dirección existe.

Connection error (Error de conexión): riesgo alto de rebote debido a problemas técnicos del lado del destinatario.

Greylisted (En lista gris): el servidor de correo utiliza filtros de lista gris, lo que dificulta la verificación de la dirección.

Hidden by owner (Oculto por el propietario): el propietario de la dirección o la empresa titular del dominio solicitó que se eliminara de los resultados de Snov.io.

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

Obtener todos los datos a partir de enlaces a perfiles de LinkedIn

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

Cómo funciona:

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

Paso 1. Envía tus datos (proporciona las URL 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 URL de LinkedIn de las que quieres obtener información. Puedes incluir hasta 10 URL por solicitud. Cada una debe ir en un parámetro independiente. 

urls[]: perfil_de_LinkedIn_1

urls[]: perfil_de_LinkedIn_2

urls[]: perfil_de_LinkedIn_3

Para recibir los resultados automáticamente, añade el parámetro "webhook_url" con la URL de destino a la que Snov.io enviará los datos enriquecidos. El uso del webhook es opcional. Si no lo configuras, puedes recuperar los resultados mediante otra solicitud a la API.

La respuesta a esta solicitud incluirá un "task_hash": un identificador único de tu solicitud. Necesitarás este ID para obtener los resultados mediante una solicitud posterior a la API.

Paso 2. Obtén los resultados (recibe los datos del perfil del prospecto)

Hay dos formas de recibir los datos enriquecidos:

  1. Webhook: Si añadiste un webhook en la solicitud anterior, enviaremos los resultados allí cuando estén listos.
  2. Solicitud independiente a la API: Utiliza 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", introduce el identificador único de la solicitud anterior en la que enviaste los datos.

Por cada enlace a un perfil de LinkedIn que hayas enviado para enriquecer, Snov.io devolverá todos los datos del prospecto correspondiente y de su empresa.

Datos del prospecto:

  • Nombre completo, nombre y apellido
  • Sector
  • País y ciudad de residencia
  • Cargo

Datos de la empresa:

  • Nombre de la empresa
  • URL de LinkedIn de la empresa
  • Dominio de la empresa
  • Sector
  • País y ciudad de ubicación

Para obtener más detalles, consulta los ejemplos de solicitudes y respuestas en nuestra documentación de la API.

Costo en créditos de la API de Enriquecimiento de datos

En la siguiente tabla, detallamos cómo Snov.io descuenta créditos del saldo de tu cuenta al utilizar solicitudes de Enriquecimiento y las API del Buscador de correos electrónicos y del Verificador de correos electrónicos.

información
Los créditos solo se descuentan por las solicitudes a la API que se completan correctamente. Si no se encuentran resultados y la respuesta no incluye datos, no se realizará ningún cargo en tu cuenta.
Enriquecimiento Solicitud a la API Créditos
Encontrar dominios a partir de nombres de empresas https://api.snov.io/v2/company-domain-by-name/start 1 crédito por cada empresa para la que Snov.io haya proporcionado un dominio.
Obtener datos de un perfil de LinkedIn a partir de su URL https://api.snov.io/v2/li-profiles-by-urls/start 1 crédito por cada URL de perfil de LinkedIn para la que Snov.io haya proporcionado información del prospecto.
Verificador de correos electrónicos: obtener el estado de verificación de una dirección https://api.snov.io/v2/email-verification/start 1 crédito por cada dirección de correo electrónico comprobada en la solicitud que obtenga un resultado válido (verde) o no válido (rojo). Los resultados amarillos (desconocidos) no generan ningún cargo.
Buscador de correos electrónicos: obtener la dirección de correo a partir del nombre del prospecto y su dominio https://api.snov.io/v2/emails-by-domain-by-name/start 1 crédito por cada prospecto de la solicitud para el que encontremos una dirección de correo electrónico válida (verde) o desconocida (amarilla).
Si la dirección de correo electrónico no es válida (not_valid), no se descuentan créditos.
Enriquecer el perfil de una persona a partir de su correo electrónico
 https://api.snov.io/v1/get-profile-by-email 1 crédito por solicitud en la que encontremos información del prospecto a partir de la dirección de correo electrónico proporcionada.
Si no encontramos información sobre el propietario de la dirección, no se te cobrará la solicitud.

Artículos relacionados

Cómo utilizar la API de Búsqueda de dominios

Cómo utilizar los webhooks

Cómo utilizar la API de Snov.io

Escrito por: Micaela Houriet

3.05.2025
Sugerir una función

Gracias por tus comentarios!

Fue útil?

No

Lo lamentamos 😢

Cómo podemos mejorarlo?