Cómo utilizar la API de Búsqueda en la base de datos

Esta guía explica cómo encontrar prospectos y empresas mediante la API de Búsqueda en la base de datos.

Métodos de la API de Búsqueda en la base de datos

• Buscar prospectos
• Encontrar el correo electrónico de un prospecto
• Buscar empresas
• Añadir prospectos a una lista

La API de Búsqueda en la base de datos es una de las varias categorías de API disponibles para automatizar tu trabajo en Snov.io.

La API de Búsqueda en la base de datos te permite acceder a la misma base de datos de prospectos y empresas que se encuentra detrás de la Búsqueda en la base de datos de la aplicación.

Úsala para encontrar prospectos y empresas mediante solicitudes a la API.

Comprobar cuántos prospectos están disponibles es gratis y solo consumes créditos cuando encuentras un correo electrónico verificado y un perfil completo. La API devuelve los mismos datos que verías en la aplicación.

Métodos de la API de Búsqueda en la base de datos

Estos son los métodos de la API, organizados según cada etapa del proceso:

Buscar prospectos

Estos métodos permiten buscar en la base de datos de prospectos de Snov.io utilizando tus filtros.

Iniciar una búsqueda de prospectos

Envía tus filtros para iniciar una búsqueda de prospectos. Recibirás un hash de tarea que podrás utilizar para obtener los resultados en el siguiente paso.

Entrada obligatoria:

Al menos un filtro. filters

Filtra tu búsqueda para encontrar los prospectos que se ajustan a tu ICP. Puedes combinar filtros a nivel de prospecto y de empresa en la misma solicitud:

• Filtros de prospectos: cargo, nivel de gestión, departamento, habilidades, ubicación, nombre y apellido
• Filtros de empresas: nombre, ubicación, sector, tamaño, rango de ingresos, especialidades y año de fundación

Los filtros de cargo reconocen las variaciones más comunes, por lo que “CEO” también coincide con “Chief Executive Officer”. Los filtros de ubicación coinciden con la lista de ubicaciones verificadas de Snov.io. Si no hay coincidencias, la API devuelve hasta 15 opciones similares en lugar de mostrar un resultado vacío.

Obtener los resultados de búsqueda de prospectos

Obtén los prospectos que coinciden con tus filtros.

Cada prospecto incluido en la respuesta muestra su cargo, ubicación, sector y datos de la empresa. El apellido y la URL de LinkedIn aparecen parcialmente ocultos hasta que inicias una búsqueda de correo electrónico.

Entrada obligatoria:

task_hash — el hash de la tarea de tu solicitud de búsqueda, incluido en la URL.

Los resultados se muestran de forma paginada, con hasta 20 prospectos por página. De forma predeterminada, obtienes la página 1; cambia el número de página para consultar los resultados de las páginas siguientes. El recuento total indica cuántos prospectos y páginas coinciden con tus filtros.

Encontrar el correo electrónico de un prospecto

Estos métodos permiten obtener la dirección de correo electrónico de un prospecto, su apellido completo y su URL completa de LinkedIn.

Iniciar la búsqueda de correo electrónico

Solicita los datos de contacto ocultos de un prospecto que hayas encontrado: utiliza su URL email_and_hidden_info_reveal para obtener su dirección de correo electrónico, apellido completo y URL completa de LinkedIn.

Entrada obligatoria:

task_hash — el hash de la tarea del prospecto, incluido en la URL.

Obtener los resultados de la búsqueda de correo electrónico

Obtén la dirección de correo electrónico del prospecto y todos los datos de su perfil.

La respuesta incluye el nombre completo del prospecto, la URL de LinkedIn y su dirección de correo electrónico, junto con su estado (válido o desconocido).

Entrada obligatoria:
task_hash — el hash de la tarea de la solicitud anterior, incluido en la URL

Buscar empresas

Estos métodos permiten buscar en la base de datos de empresas de Snov.io. Utiliza la búsqueda de empresas para crear una lista de cuentas objetivo antes de buscar personas dentro de esas empresas.

Iniciar una búsqueda de empresas

Envía tus filtros para iniciar una búsqueda de empresas.

Recibirás un hash de tarea que podrás utilizar para obtener los resultados en el siguiente paso. Los filtros incluyen nombre de la empresa, ubicación, sector, tamaño, ingresos, especialidades y año de fundación.

Entrada obligatoria:
Al menos un filtro. filters

Obtener los resultados de búsqueda de empresas

Obtén las empresas que coinciden con tus filtros.

Cada empresa incluida en la respuesta muestra su dominio, ubicación, sector, tamaño, rango de ingresos y logotipo.

Entrada obligatoria:
task_hash — el hash de la tarea de tu solicitud de búsqueda, incluido en la URL

Se te cobra 1 crédito por cada solicitud única y solo si los resultados incluyen al menos una empresa.

Añadir prospectos a una lista

Una vez que hayas encontrado los correos electrónicos que buscas, utiliza este método para añadir esos prospectos a una lista de Snov.io. Después, puedes lanzar una campaña de prospección de la misma forma que lo harías con los prospectos añadidos desde la aplicación.

Siguientes pasos con la API

Ejecutar campañas de prospección

Crea y lanza secuencias de prospección multicanal para los prospectos que hayas encontrado. Consulta la API de Campañas.

Coste en créditos de la API de Búsqueda en la base de datos

En la siguiente tabla, te explicamos cómo Snov.io descuenta créditos de tu saldo de cuenta al utilizar solicitudes de la API de Búsqueda en la base de datos.