Como usar as ferramentas da Snov.io via API

As principais ferramentas da Snov.io podem ser utilizadas via API REST. Encontre prospects, enriqueça seus dados, verifique e-mails, execute campanhas de prospecção e acompanhe o desempenho — tudo por meio da API.

APIs da Snov.io

Veja abaixo os métodos disponíveis em cada categoria de API:

API de Pesquisa por Domínio

API de Enriquecimento de Dados

API de Localização de E-mails

API de Verificação de E-mails

API de Gerenciamento de Prospects

API de Contas de E-mail

API de Aquecimento de E-mail

API de Campanhas Multicanal

API de Conteúdo de Campanha

API de Analytics e Relatórios

Webhooks

Como obter seu token de acesso à API

• Envie seu API User ID e API Secret no corpo da solicitação. Você receberá um token de acesso como resposta.
• O token de acesso é válido por 1 hora (3600 segundos).
• Inclua o token no cabeçalho Authorization de todas as solicitações.

API de Pesquisa por Domínio

Encontre informações de empresas, perfis de prospects e endereços de e-mail com base em um domínio. Nesta API, os métodos POST iniciam uma pesquisa e retornam um task_hash, em seguida, um método GET recupera os resultados.

Consulte os detalhes completos dos métodos na documentação da API.

Método	Endpoint	Finalidade
POST	https://api.snov.io/v2/domain-search/start	Solicitar informações de uma empresa por domínio
GET	https://api.snov.io/v2/domain-search/result/{task_hash}	Obter resultados das informações da empresa
POST	https://api.snov.io/v2/domain-search/prospects/start	Pesquisar prospects por domínio + filtros de cargo
GET	https://api.snov.io/v2/domain-search/prospects/result/{task_hash}	Obter resultados da pesquisa de prospects
POST	https://api.snov.io/v2/domain-search/domain-emails/start	Pesquisar e-mails por domínio
GET	https://api.snov.io/v2/domain-search/domain-emails/result/{task_hash}	Obter resultados dos e-mails do domínio
POST	https://api.snov.io/v2/domain-search/generic-contacts/start	Pesquisar e-mails genéricos/baseados em função
GET	https://api.snov.io/v2/domain-search/generic-contacts/result/{task_hash}	Obter resultados dos contatos genéricos

API de Enriquecimento de Dados

Obtenha prospects completos, com cargos e e-mails verificados, a partir do nome + domínio ou nome da empresa.

Consulte os detalhes completos dos métodos na documentação da API.

Método	Endpoint	Finalidade
POST	https://api.snov.io/v2/company-domain-by-name/start	Enriquecer o domínio com base no nome da empresa
POST	https://api.snov.io/v2/emails-by-domain-by-name/start	Enriquecer o endereço de e-mail com base no nome do prospect e domínio
POST	https://api.snov.io/v2/li-profiles-by-urls/start	Enriquecer o perfil de uma pessoa a partir da URL do LinkedIn
GET	https://api.snov.io/v1/get-profile-by-email	Enriquecer o perfil de uma pessoa a partir do endereço de e-mail

API de Localização de E-mails

Obtenha prospects completos, com cargos e e-mails verificados, a partir do nome + domínio ou nome da empresa.

Consulte os detalhes completos dos métodos na documentação da API.

Método	Endpoint	Finalidade
POST	/v2/emails-by-domain-by-name/start	Encontrar e-mails a partir do nome + domínio (em massa: até 10 por solicitação)
GET	/v2/emails-by-domain-by-name/result	Recuperar e-mails encontrados
POST	/v2/company-domain-by-name/start	Encontrar domínio a partir do nome da empresa (em massa: até 10 por solicitação)
GET	/v2/company-domain-by-name/result	Recuperar domínios das empresas

API de Verificação de E-mails

Verifique a entregabilidade de e-mails com um processo de verificação em múltiplas etapas. Retorna os status valid, not_valid, ou unknown , juntamente com os motivos detalhados. Valide listas obtidas de terceiros ou integre a verificação para validar e-mails durante o cadastro.

Consulte os detalhes completos dos métodos na documentação da API.

Método	Endpoint	Finalidade
POST	https://api.snov.io/v2/email-verification/start	Enviar e-mails para verificação (até 10 e-mails por solicitação)
GET	https://api.snov.io/v2/email-verification/result	Obter resultados da verificação

API de Gerenciamento de Prospects

Gerencie prospects na sua conta. Automatize tarefas rotineiras, como criar listas e organizar prospects por segmento.

Consulte os detalhes completos dos métodos na documentação da API.

Método	Endpoint	Finalidade
POST	https://api.snov.io/v1/add-prospect-to-list	Adicionar prospect a uma lista
POST	https://api.snov.io/v1/lists	Criar nova lista de prospects
GET	https://api.snov.io/v1/prospect-list	Visualizar prospects da lista

API de Contas de E-mail

Gerencie contas de envio de e-mails. Conecte, configure e verifique o status das contas.

Consulte os detalhes completos dos métodos na documentação da API.

Método	Endpoint	Finalidade
POST	https://api.snov.io/v2/sender-accounts/emails	Adicionar nova conta de e-mail
PATCH	https://api.snov.io/v2/sender-accounts/emails/{id}	Atualizar configurações da conta de e-mail
GET	https://api.snov.io/v2/sender-accounts/check-sender-status	Listar todas as contas de remetente
GET	https://api.snov.io/v2/sender-accounts/emails	Verificar o status de conexão da conta

API de Aquecimento de E-mail

Inicie o aquecimento de contas de remetente antes das campanhas de prospecção para proteger a entregabilidade e melhorar a reputação do remetente.

Consulte os detalhes completos dos métodos na documentação da API.

Método	Endpoint	Finalidade
POST	https://api.snov.io/v2/warm-up	Criar campanha de aquecimento
PATCH	https://api.snov.io/v2/warm-up/{id}	Atualizar configurações de aquecimento
GET	https://api.snov.io/v2/warm-up	Listar campanhas de aquecimento
GET	https://api.snov.io/v2/warm-up/statistics/{id}	Obter estatísticas diárias de aquecimento

API de Campanhas Multicanal

Gerencie todo o fluxo de prospecção: crie, configure, lance e monitore campanhas.

Consulte os detalhes completos dos métodos na documentação da API.

Método	Endpoint	Finalidade
POST	https://api.snov.io/ v2/campaigns/create	Criar nova campanha
GET	https://api.snov.io/ v2/campaigns/{campaign_id}	Obter detalhes da campanha
PATCH	https://api.snov.io/ v2/campaigns/{campaign_id}	Atualizar configurações da campanha
POST	https://api.snov.io/ v2/campaigns/{campaign_id}/action	Alterar status da campanha (iniciar/pausar/retomar/concluir/arquivar)
DELETE	https://api.snov.io/ v2/campaigns/{campaign_id}	Excluir campanha
GET	https://api.snov.io/ v2/campaigns/schedules	Obter agendas de envio adicionadas no aplicativo
GET	https://api.snov.io/ v2/blacklists	Obter listas de bloqueio (do-not-contact)

API de Conteúdo de Campanha

Gerencie o conteúdo das etapas de e-mail (assuntos e corpos de mensagem) dentro das sequências de campanha.

Consulte os detalhes completos dos métodos na documentação da API.

Método	Endpoint	Finalidade
POST	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/create	Criar ou atualizar conteúdo de e-mail
GET	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/{content_id}	Obter conteúdo de e-mail
PATCH	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/{content_id}	Atualizar conteúdo de e-mail
DELETE	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/{content_id}	Excluir conteúdo de e-mail

API de Analytics e Relatórios

Recupere dados de engajamento e desempenho de campanhas nos canais de e-mail e LinkedIn.

Consulte os detalhes completos dos métodos na documentação da API.

Método	Endpoint	Finalidade
GET	https://api.snov.io/ v2/statistics/campaign-analytics	Métricas agregadas de campanha com base nos filtros aplicados
GET	https://api.snov.io/ v2/campaigns/[campaign_id]/progress	Progresso de conclusão da campanha
GET	https://api.snov.io/ v2/campaigns/[campaign_id]/all-replies	Dados de respostas da campanha (e-mail + LinkedIn)
GET	https://api.snov.io/ v1/get-emails-replies	Respostas da campanha (apenas e-mail)
GET	https://api.snov.io/ v1/get-emails-opened	Dados de abertura de e-mails
GET	https://api.snov.io/ v1/get-emails-clicked	Dados de cliques em links
GET	https://api.snov.io/ v1/emails-sent	Registro de e-mails enviados
GET	https://api.snov.io/ v1/get-user-campaigns	Listar todas as campanhas

Webhooks

Configure automações que reagem em tempo real ao engajamento dos prospects e à atividade das campanhas. Os webhooks podem enviar dados de atividade de campanhas de e-mail e LinkedIn para a URL do seu endpoint.

Isso inclui respostas, respostas automáticas, aberturas de e-mail, cliques, conclusão de sequências e muito mais.

Consulte a lista completa de webhooks aqui.