Como usar a API de Pesquisa de Banco de Dados

Este guia explica como encontrar prospects e empresas pela API de busca no banco de dados.

Métodos da API de busca no banco de dados

Pesquisar prospects
Encontrar o e-mail de um prospect
Pesquisar empresas
Adicionar prospects a uma lista

A API de busca no banco de dados é uma das várias categorias de API disponíveis para automatizar seu trabalho na Snov.io.

A API de Pesquisa de banco de dados permite acessar o mesmo banco de dados de prospects e empresas usado pela Pesquisa de banco de dados no aplicativo.

Use-a para encontrar prospects e empresas por meio de solicitações à API.

Verificar quantos prospects estão disponíveis é gratuito, e você consome créditos apenas quando encontra um e-mail verificado e um perfil completo. A API retorna os mesmos dados que você veria no aplicativo.

Métodos da API de pesquisa de banco de dados

Veja abaixo os métodos da API divididos por etapa do fluxo de trabalho:

Pesquisar prospects

Esses métodos pesquisam o banco de dados de prospects da Snov.io usando seus filtros.

Iniciar uma pesquisa de prospects

Envie seus filtros para iniciar uma pesquisa de prospects. Você receberá um hash da tarefa para recuperar os resultados na próxima etapa.

POST https://api.snov.io/v2/database-search/prospects/start

Input obrigatório:
Pelo menos um filtro. filters

Restrinja sua pesquisa aos prospects que correspondem ao seu ICP. Você pode combinar filtros de prospects e de empresas na mesma solicitação:

Filtros de prospects: cargo, nível de gestão, departamento, habilidades, localização, nome e sobrenome
Filtros de empresas: nome, localização, setor, porte, faixa de receita, especialidades, ano de fundação

Os filtros de cargo reconhecem variações comuns, portanto, "CEO" também corresponde a "Chief Executive Officer". Os filtros de localização correspondem à lista de localizações verificadas da Snov.io. Se nenhuma correspondência for encontrada, a API retorna até 15 opções semelhantes em vez de um resultado vazio.

Obter resultados da pesquisa de prospects

Recupere os prospects que correspondem aos seus filtros.

Cada prospect na resposta inclui cargo, localização, setor e dados da empresa. O sobrenome e a URL do LinkedIn ficam parcialmente ocultos até que você inicie uma pesquisa de e-mail.

GET https://api.snov.io/v2/database-search/prospects/result/{task_hash}

Input obrigatório:
task_hash — o hash da tarefa da sua solicitação de pesquisa, na URL

Os resultados são paginados, com até 20 prospects por página. A página 1 é exibida por padrão. Altere o número da página para obter resultados de páginas posteriores. A contagem total mostra quantos prospects e páginas correspondem aos seus filtros.

Encontrar o e-mail de um prospect

Esses métodos obtêm o endereço de e-mail, o sobrenome completo e a URL completa do LinkedIn de um prospect.

Iniciar a pesquisa de e-mail

Solicite os dados de contato ocultos de um prospect que você encontrou: use a URL email_and_hidden_info_reveal ara obter o endereço de e-mail, o sobrenome completo e a URL completa do LinkedIn.

POST https://api.snov.io/v2/database-search/prospects/search-emails/start/{task_hash}

Input obrigatório:
task_hash — o hash da tarefa do prospect, na URL

Obter resultados da pesquisa de e-mail

Obtenha o endereço de e-mail do prospect e os dados completos do perfil.

A resposta inclui o nome completo do prospect, a URL do LinkedIn e o endereço de e-mail com seu status (válido ou desconhecido).

GET https://api.snov.io/v2/database-search/prospects/search-emails/result/{task_hash}

Input obrigatório:
task_hash — o hash da tarefa da solicitação anterior, na URL

Pesquisar empresas

Esses métodos pesquisam o banco de dados de empresas da Snov.io. Use a pesquisa de empresas para criar uma lista de contas-alvo antes de pesquisar pessoas dentro dessas empresas.

Iniciar uma pesquisa de empresas

Envie seus filtros para iniciar uma pesquisa de empresas.

Você receberá um hash da tarefa para recuperar os resultados na próxima etapa. Os filtros abrangem nome da empresa, localização, setor, porte, receita, especialidades e ano de fundação.

POST https://api.snov.io/v2/database-search/companies/start

Input obrigatório:
Pelo menos um filtro. filters

Obter resultados da pesquisa de empresas

Recupere as empresas que correspondem aos seus filtros.

Cada empresa na resposta inclui domínio, localização, setor, porte, faixa de receita e logo.

GET https://api.snov.io/v2/database-search/companies/result/{task_hash}

Input obrigatório:
task_hash — o hash da tarefa da sua solicitação de pesquisa, na URL

É cobrado 1 crédito por cada solicitação exclusiva, e somente se os resultados incluírem pelo menos uma empresa.

Adicionar prospects a uma lista

Depois de encontrar os e-mails desejados, adicione esses prospects a uma lista da Snov.io com este método. Em seguida, inicie uma campanha de prospecção da mesma forma que faria com prospects adicionados pelo aplicativo.

POST https://api.snov.io/v1/add-prospect-to-list

Próximas etapas na API

Executar campanhas de outreach

Crie e lance sequências de prospecção multicanal para os prospects encontrados. Consulte a API de campanhas

Custo em créditos da API de Pesquisa de Banco de Dados

Na tabela abaixo, apresentamos detalhes sobre como a Snov.io cobra créditos do saldo da sua conta ao usar solicitações da API de busca no banco de dados.

Método	Solicitação à API	Créditos
Iniciar uma pesquisa de prospects	https://api.snov.io/v2/database-search/prospects/start	Grátis
Obter resultados da pesquisa de prospects	https://api.snov.io/v2/database-search/prospects/result/{task_hash}	Grátis
Iniciar a pesquisa de e-mail	https://api.snov.io/v2/database-search/prospects/search-emails/start/{task_hash}	Grátis
Obter resultados da pesquisa de e-mail	https://api.snov.io/v2/database-search/prospects/search-emails/result/{task_hash}	1 crédito para cada prospect para o qual encontramos um endereço de e-mail válido ou não verificável. Se nenhum e-mail for encontrado, não cobramos créditos.
Iniciar uma pesquisa de empresas	https://api.snov.io/v2/database-search/companies/start	Grátis
Obter resultados da pesquisa de empresas	https://api.snov.io/v2/database-search/companies/result/{task_hash}	1 crédito para cada solicitação exclusiva na qual retornamos pelo menos uma empresa. Se nenhuma empresa corresponder aos filtros, não cobramos créditos.
Adicionar prospects a uma lista	https://api.snov.io/v1/add-prospect-to-list	Grátis