Como enriquecer seus dados via API da Snov.io

Como usar a API de Enriquecimento de Dados da Snov.io:

- Automatize seu processo de geração de leads e verifique e-mails corporativos

- Expanda seus conjuntos de dados existentes com informações adicionais

- Enriqueça seu aplicativo com os nossos dados

- Integre as ferramentas da Snov.io aos seus fluxos de trabalho existentes

Como funciona o enriquecimento de dados:

Envie os dados que você já possui para a Snov.io por meio de uma requisição via API. Nós comparamos suas informações com nosso banco de dados ou as encontramos para você. Em troca, você recebe os dados enriquecidos.

Esse processo enriquece automaticamente suas informações existentes com dados de vendas atualizados. Usar a API torna isso escalável, seja para enriquecer 10 ou 10.000 registros.

Encontrar domínios a partir de nomes de empresas

Com o enriquecimento de nomes de domínio, é possível encontrar o domínio (site) de uma empresa informando seu nome oficial exato.

Como funciona:

1) Envie os nomes das empresas para a API.

2) Receba os domínios correspondentes das empresas em retorno.

Para encontrar e-mails e prospects a partir de domínios, use a API de Busca por Domínio (Domain Search API).

Etapa 1: Envie seus dados (informe os nomes das empresas)

URL da requisição:: https://api.snov.io/v2/company-domain-by-name/start

Tipo da requisição: POST

No parâmetro "names[]", insira o nome da empresa para a qual você deseja receber o domínio.

Você pode enriquecer até 10 empresas por requisição. Adicione o nome de cada empresa em um parâmetro separado.

names[]: company_1
names[]: company_2

Para receber os resultados automaticamente, adicione o parâmetro "webhook_url" com a URL de destino onde a Snov.io enviará os dados enriquecidos.

Você também pode obter automaticamente informações sobre outros eventos em sua conta. Veja a lista completa de webhooks aqui.

O uso do webhook é opcional. Se você optar por não usá-lo, poderá recuperar os resultados com uma requisição de API separada.

A resposta fornecerá um "task_hash": um identificador exclusivo para sua requisição. Você precisará desse ID para obter seus resultados por meio de uma requisição de API de acompanhamento.

Etapa 2. Obter resultados (receber os domínios das empresas)

Existem duas maneiras de receber seus dados enriquecidos:

1. Webhook: Se você adicionou um webhook na requisição anterior, enviaremos os resultados para lá quando estiverem prontos.

2. Requisição de API separada: Use a seguinte requisição para obter os resultados.

Tipo da requisição: GET

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

No parâmetro "task_hash", adicione o ID exclusivo da sua requisição anterior, onde você enviou os dados.

Para cada empresa que você solicitou, a API da Snov.io retornará os seguintes campos de dados:

• "name": O nome original da empresa que você forneceu

• "domain": O endereço de domínio da empresa

Para mais detalhes, consulte os exemplos de requisição e resposta na nossa documentação da API.

Encontrar endereços de e-mail a partir de nomes e domínios

Usando a API de Email Finder, você pode encontrar endereços de e-mail corporativos verificados fornecendo o nome de um prospect e o domínio de sua empresa.

Como funciona:

1. Envie o primeiro nome, o sobrenome do prospect e o nome do domínio da empresa para a API.

2. Receba o endereço de e-mail e o status de verificação em retorno.

Etapa 1: Envie seus dados (forneça o nome e o domínio).

Tipo da requisição: POST

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

No parâmetro "rows", forneça as informações sobre o prospect: primeiro nome, sobrenome e domínio.

A API de Email Finder suporta busca em massa. Você pode enriquecer até 10 prospects em uma única requisição de API. Nós encontraremos e verificaremos o endereço de e-mail do prospect. A verificação em várias etapas garante que você receba e-mails corporativos precisos.

Para cada prospect na sua requisição, inclua um array de dados com os seguintes campos:

No campo "first_name", forneça o primeiro nome do prospect.

No campo "last_name", forneça o sobrenome do prospect.

No campo "domain", forneça o nome do domínio da empresa para a qual o prospect trabalha.

Exemplo:

"first_name": primeiro nome do prospect

"last_name": sobrenome do prospect

"domain": site da empresa

Para receber os resultados da busca automaticamente, adicione o parâmetro "webhook_url" com a URL de destino onde a Snov.io enviará os resultados. O uso do webhook é opcional. Se você optar por não usá-lo, poderá recuperar os resultados com uma requisição de API separada.

A resposta fornecerá um "task_hash": um identificador único para a sua requisição. Você precisará desse ID para obter os resultados ao fazer uma requisição de API de acompanhamento.

Etapa 2. Obter resultados (receber um endereço de e-mail verificado)

Existem duas maneiras de obter os resultados:

1. Webhook: Se você adicionou um webhook na requisição anterior, enviaremos os resultados para lá assim que a busca for concluída.

2. Requisição de API separada:

Tipo da requisição: GET

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

No parâmetro "task_hash" para esta requisição, adicione o ID único que você recebeu da sua requisição anterior, onde você enviou os dados.

Para cada prospect que você adicionou à requisição, a Snov.io retornará os seguintes dados:

• O endereço de e-mail

• O status de verificação (válido, inválido ou desconhecido)

• Os resultados de verificações adicionais que confirmam a validade ou explicam o motivo pelo qual o status é desconhecido

Para mais detalhes, consulte nossa documentação da API.

Tipo da requisição: POST

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

No parâmetro "emails[]", insira os endereços de e-mail para os quais você deseja verificar o status.

Você pode verificar até 10 e-mails por requisição. Adicione cada endereço de e-mail em um parâmetro separado.

• emails[]: email_address_1

• emails[]: email_address_2

• emails[]: email_address_3

Para receber os resultados de verificação automaticamente, adicione o parâmetro "webhook_url" com a URL de destino onde a Snov.io enviará os resultados. O uso do webhook é opcional. Se você optar por não usá-lo, poderá recuperar os resultados com uma requisição de API separada.

A resposta fornecerá um "task_hash": um identificador único para sua requisição. Você precisará desse ID para recuperar seus resultados ao fazer uma requisição de API de acompanhamento.

Etapa 2. Obter resultados (receber o status de e-mail)

Existem duas maneiras de receber os resultados:

1. Webhook: Se você adicionou um webhook na requisição anterior, enviaremos os resultados para lá assim que estiverem prontos.

2. Requisição de API: Use a seguinte requisição.

Tipo da requisição: GET

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

No parâmetro "task_hash", adicione o ID único recebido da sua requisição anterior, onde você enviou os dados.

Para cada endereço de e-mail que você adicionou para verificação, a Snov.io verificará e retornará um dos três status:

• valid: O endereço de e-mail existe e pode receber mensagens.

• not_valid: O e-mail não existe ou não pode receber mensagens.

• unknown (Não verificável): O endereço de e-mail não pôde ser verificado com 100% de certeza, mas ainda é provavelmente válido.

Para e-mails com status "unknown", fornecemos uma razão detalhada conforme determinado durante a verificação. Pode ser um dos seguintes motivos:

• Banned: Alto risco de entregabilidade – o endereço de e-mail não pôde ser verificado com 100% de certeza.

• Catchall: Risco de reputação do remetente – o servidor de e-mail usa uma "política catch-all", tornando impossível confirmar a existência do e-mail.

• Connection error: Alto risco de retorno devido a problemas técnicos no lado do destinatário.

• Greylisted: O servidor de e-mail usa filtros de graylisting, dificultando a verificação do endereço de e-mail.

• Hidden by owner: O proprietário do e-mail ou a empresa dona do domínio solicitou a remoção dos resultados na Snov.io.

Veja a lista completa de campos enriquecidos na documentação da API.

Obter dados completos a partir de links de perfil do LinkedIn

Usando o enriquecimento de perfil do LinkedIn, você pode obter informações sobre o prospect fornecendo o link do perfil dele.

Como funciona:

1. Forneça a URL do perfil do LinkedIn para a API.

2. Receba os detalhes completos do prospect, incluindo título do cargo e outras informações.

Etapa 1: Envie seus dados (forneça os links do LinkedIn).

Tipo da requisição: POST

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

No parâmetro "urls[]", adicione as URLs do LinkedIn para as quais você deseja receber as informações. Você pode adicionar até 10 URLs por requisição. Cada URL deve estar em um parâmetro separado.

• urls[]: LinkedIn_profile_1

• urls[]: LinkedIn_profile_2

• urls[]: LinkedIn_profile_3

Para receber os resultados automaticamente, adicione o parâmetro "webhook_url" com a URL de destino onde a Snov.io enviará os dados enriquecidos. O uso do webhook é opcional. Se você optar por não usá-lo, poderá recuperar os resultados com uma requisição de API separada.

A resposta para esta requisição fornecerá um "task_hash": um identificador único para a sua requisição. Você precisará desse ID para obter os resultados ao fazer uma requisição de API de acompanhamento.

Etapa 2. Obter resultados (receber informações do perfil do prospect)

Existem duas maneiras de receber os dados enriquecidos:

1. Webhook: Se você adicionou um webhook na requisição anterior, enviaremos os resultados para lá assim que estiverem prontos.

2. Requisição de API separada: Use a seguinte requisição.

Tipo da requisição: GET

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

No parâmetro "task_hash", adicione o ID único da sua requisição anterior de "enviar dados".

Para cada link de perfil do LinkedIn que você adicionou para enriquecimento, a Snov.io retornará os dados completos para o prospect e a empresa a que ele pertence.

Dados do prospect:

• Nome completo, primeiro nome, sobrenome

• Indústria

• País, cidade de localização

• Cargo

Dados da empresa:

• Nome da empresa

• URL do LinkedIn da empresa

• Domínio da empresa

• Indústria

• País e cidade de localização

Para mais detalhes, consulte os exemplos de requisição e resposta na nossa documentação da API.

Custo de créditos da API de Enriquecimento de Dados

Na tabela abaixo, forneceremos detalhes sobre como a Snov.io cobra créditos do seu saldo de conta ao usar as requisições para as APIs de Enriquecimento, Email Finder e Email Verifier.

Os créditos são descontados apenas para requisições de API bem-sucedidas. Se nenhum resultado for encontrado e nenhum dado for fornecido na resposta, sua conta não será cobrada.