API da Snov.io

Você pode usar os recursos da Snov.io por meio da nossa API REST simples. Faça a integração com a API da Snov.io para sincronizar seus leads, encontrar e-mails, gerenciar clientes potenciais e muito mais. A taxa de API é limitada a 60 solicitações por minuto.

Usuários do Snov.io com plano gratuito podem testar o recurso de API sem precisar fazer upgrade entrando em contato conosco: suporte@snov.io.

Autenticação

Você precisa gerar um token de acesso para autenticar solicitações futuras. Ao fazer uma solicitação, especifique esse token de acesso no campo Autorização.

Authorization: Bearer QSlHffXmCAILIOHNGXToq4LsP2yX64VQhEBZ7Ei4

Aqui está um exemplo para geração de token.

Solicitação
POSThttps://api.snov.io/v1/oauth/access_token
Parâmetros de entrada
grant_type
Será sempre
client_credentials
client_id
Seu ID está disponível nas configurações da contahttps://app.snov.io/account#/api
client_secret
Sua chave secreta está disponível nas configurações da contahttps://app.snov.io/account#/api
Exemplos de código
<?php
function getAccessToken()
{
    $params = [
        'grant_type'    => 'client_credentials',
        'client_id'     => 'c57a0459f6t141659ea75cccb393c5111',
        'client_secret' => '77cbf92b71553e85ce3bfd505214f40b'
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/oauth/access_token',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res['access_token'];

}
?>
def get_access_token():
params = {
    'grant_type':'client_credentials',
    'client_id':'c57a0459f6t141659ea75cccb393c111',
    'client_secret': '77cbf92b71553e85ce3bfd505214f40b'
}

res = requests.post('https://api.snov.io/v1/oauth/access_token', data=params)
resText = res.text.encode('ascii','ignore')

return json.loads(resText)['access_token']
Exemplo de resposta
{
"access_token":"3yUyQZdks0Ej7T2fXzjUWzwlTcO4dWisKkeMpESz",
"token_type":"Bearer",
"expires_in":3600
}
Parâmetros de saída
access_token
Seu novo token de acesso
token_type
Será sempre Bearer
expires_in
Hora de expiração do token (em segundos)

Métodos de API

POSTPesquisa de domínios

1 crédito por solicitação distinta / 1 crédito por e-mail de perfil de cliente potencial

Enter a domain name and Snov.io will return company info, emails and prospect profiles.

Custo em créditos
Solicitações de informações da empresa, e-mails e perfis de clientes potenciais

1 crédito por solicitação POST. Não cobraremos você se não houver resultados.

E-mails de perfis de clientes potenciais

1 crédito por perfil de cliente potencial com e-mail.

Domain search schema
Informações da empresa (solicitar resultados)
1 crédito por solicitação distinta.
POSThttps://api.snov.io/v2/domain-search/start
Parâmetros de entrada
domain
O nome do domínio para o qual você deseja localizar e-mails da empresa. Por exemplo, "snov.io".
Exemplos de código
<?php
function companyInfoSearch()
{
    $token = getAccessToken();

    $params = [
        'domain' => 'snov.io',
    ];
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def company_info_search():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'domain': 'snov.io',
}

res = requests.post('https://api.snov.io/v2/domain-search/start', params=params, headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": [],
  "meta": {
    "domain": "snov.io",
    "task_hash": "6f15de14db954c761f8e7507547b3bd7"
  },
  "links": {
    "result": "https://api.snov.io/v2/domain-search/result/6f15de14db954c761f8e7507547b3bd7"
  }
}
Parâmetros de saída
domain
Domínio para o qual você está recuperando informações da empresa.
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou. É adicionado automaticamente ao URL da sua próxima solicitação para receber os resultados.
result
URL de solicitação para você usar a fim de receber informações da empresa.
Informações da empresa (obter resultados)
URL recebido da sua solicitação anterior.
GEThttps://api.snov.io/v2/domain-search/result/{task_hash}
Exemplos de código
<?php
function companyInfoResult()
{
    $token = getAccessToken();

    $task_hash = 'b10e4c47693dbf87cc8de16edcc8ae22';
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/result/$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def company_info_result():
token = get_access_token()
task_hash = '86586db9ac64ae5471eb18fc71b0dd5e'
headers = {'authorization': f'Bearer {token}'}

res = requests.get(f'https://api.snov.io/v2/domain-search/result/{task_hash}', headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": {
    "company_name": "Snov.io",
    "city": "New York",
    "founded": "2017",
    "website": "snov.io",
    "hq_phone": "13477050819",
    "industry": "Computer Software",
    "size": "51-200",
    "related_domains": [
      "snov.me",
      "snov.com",
      "snov.nl",
      "snov.com.ua",
      "snov.cl"
    ]
  },
  "meta": {
    "domain": "snov.io",
    "task_hash": "6f15de14db954c761f8e7507547b3bd7",
    "prospects_count": 196,
    "emails_count": 108,
    "generic_contacts_count": 9
  },
  "links": {
    "prospects": "https://api.snov.io/v2/domain-search/prospects/start?domain=snov.io",
    "domain_emails": "https://api.snov.io/v2/domain-search/domain-emails/start?domain=snov.io",
    "generic_contacts": "https://api.snov.io/v2/domain-search/generic-contacts/start?domain=snov.io"
  },
  "status": "completed"
}
Parâmetros de saída
company_name
O nome da empresa associada ao domínio.
city
A cidade onde a sede da empresa está localizada.
founded
O ano em que a empresa foi fundada.
website
Endereço do site da empresa.
hq_phone
O número de telefone da sede da empresa.
industry
Setor da empresa.
size
Número de funcionários da empresa.
related_domains
Domínios com o mesmo SLD (domínio de segundo nível) que o domínio para o qual você está solicitando dados.
domain
O nome do domínio para o qual a API forneceu as informações da empresa.
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou.
prospects_count
O número de perfis de clientes potenciais obtidos a partir da sua solicitação.
emails_count
O número de e-mails do domínio obtidos a partir da sua solicitação.
generic_contacts_count
O número de e-mails genéricos obtidos a partir da sua solicitação.
prospects
URL para solicitar uma lista com perfis completos de clientes potenciais.
domain_emails
URL para solicitar uma lista com e-mails do domínio.
generic_contacts
URL para solicitar uma lista com e-mails genéricos de empresa.
status
Status da solicitação. Pode ser completed ou in progress.
Perfis de clientes potenciais (solicitar resultados)
1 crédito por solicitação distinta.
POSThttps://api.snov.io/v2/domain-search/prospects/start
Parâmetros de entrada
domain
O nome do domínio para o qual você deseja localizar perfis de clientes potenciais. Por exemplo, "snov.io".
positions[]
Use este parâmetro para filtrar clientes potenciais por cargo. Por exemplo, "desenvolvedor de software". Para filtrar por vários cargos, insira uma matriz de cargos obrigatórios, separados por vírgula.

Você pode filtrar até 10 cargos por solicitação.
page
Número da página que contém perfis de clientes potenciais. Cada página mostra até 20 perfis.

Se não for indicada nenhuma página, será retornada a primeira página como padrão.
Exemplos de código
<?php
function prospectsSearch()
{
    $token = getAccessToken();

    $params = [
        'domain'       => 'snov.io',
        'page'         => 1,
        'positions'    => ['Web developer','QA Engineer']
    ];

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query($params),
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def prospects_search():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'domain': 'snov.io',
  'page': 1,
  'positions[]': ['Web developer', 'QA Engineer']
}

res = requests.post('https://api.snov.io/v2/domain-search/prospects/start', params=params, headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": [],
  "meta": {
    "domain": "snov.io",
    "tab": "prospects",
    "task_hash": "3384369c16aad810f58609a40ad65089",
    "page": 1,
    "positions": [
      "Web developer",
      "QA Engineer"
    ]
  },
  "links": {
    "result": "https://api.snov.io/v2/domain-search/prospects/result/3384369c16aad810f58609a40ad65089"
  }
}
Parâmetros de saída
domain
Domínio para o qual você está recuperando perfis de cliente potencial.
tab
Exibe o tipo de resultados que você vai solicitar.

prospects indica que você está procurando perfis de clientes potenciais.

emails exibe e-mails de domínio.

service mostra que você vai receber e-mails genéricos.
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou. É adicionado automaticamente ao URL da sua próxima solicitação para receber os resultados.
page
Número da página que contém perfis de clientes potenciais. Cada página mostra até 20 perfis.
positions
Cargos usados para filtrar os resultados.
result
URL de solicitação para você usar a fim de receber perfis de clientes potenciais.
Perfis de clientes potenciais (obter resultados)
URL recebido da sua solicitação anterior.
GEThttps://api.snov.io/v2/domain-search/prospects/result/{task_hash}
Exemplos de código
<?php
function prospectsResult()
{
    $token = getAccessToken();

    $task_hash = '3384369c16aad810f58609a40ad65089';
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/prospects/result/$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def prospects_result():
token = get_access_token()
task_hash = '3384369c16aad810f58609a40ad65089'
headers = {'authorization': f'Bearer {token}'}

res = requests.get(f'https://api.snov.io/v2/domain-search/prospects/result/{task_hash}', headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "position": "Web developer",
      "source_page": "https://www.linkedin.com/in/john-doe/",
      "search_emails_start": "https://api.snov.io/v2/domain-search/prospects/search-emails/start/41627edbfff8ba9c0819a1aa51d232baf3fa1763e5813dc86e027ccbbefd7a16b0522391086776b8764c94d02bab1257df392"
    }
  ],
  "meta": {
    "domain": "snov.io",
    "tab": "prospects",
    "task_hash": "3384369c16aad810f58609a40ad65089",
    "page": 1,
    "positions": [
      "Web developer",
      "QA Engineer"
    ],
    "total_count": 18
  },
  "links": {
    "next": ""
  },
  "status": "completed"
}
Parâmetros de saída
first_name
Nome do cliente potencial.
last_name
Sobrenome do cliente potencial.
position
Cargo do cliente potencial.
source_page
A página de origem dos dados pessoais recuperados.
search_emails_start
URL da sua próxima solicitação de pesquisar o e-mail do cliente potencial.
domain
Domínio para o qual você está recuperando perfis de cliente potencial.
tab
Exibe o tipo de resultados que você vai receber.

prospects indica que você está procurando perfis de clientes potenciais.

emails exibe e-mails de domínio.

service mostra que você vai receber e-mails genéricos.
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou.
page
Número da página que contém perfis de clientes potenciais. Cada página mostra até 20 perfis.
positions
Cargos usados para filtrar os resultados.
total_count
Número total de perfis de clientes potenciais encontrados.
next
URL da sua próxima solicitação de obter os resultados da página a seguir. Cada página tem até 20 clientes potenciais.
status
Status da solicitação. Pode ser completed ou in progress.
E-mail do cliente potencial (solicitar resultados)
URL recebido da sua solicitação anterior. Cobraremos de você 1 crédito por cliente potencial com e-mail.
POSThttps://api.snov.io/v2/domain-search/prospects/search-emails/start/{prospect_hash}
Exemplos de código
<?php
function searchProspectEmailsStart()
{
    $token = getAccessToken();

    $headers = [
        'Authorization: Bearer ' . $token,
    ];
    $task = '41627edbfff8ba9c0819a1aa51d232baf3fa1763e5813dc86e027ccbbefd7a16b0522391086776b8764c94d02bab1257df392';

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/prospects/search-emails/start/$task',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def search_prospect_emails_start():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}

res = requests.post(f'https://api.snov.io/v2/domain-search/prospects/search-emails/start/'
  f'a811d72df2e52bd447621c4a1326e540102f3b70ba39a81bd597020ed0b9f812ee8de7e0f4ecad312716d03576fdf0af6d8277e1', headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": [],
  "meta": {
    "task_hash": "5e846a1d80d95f66cfb30250a7c1881f"
  },
  "links": {
    "result": "https://api.snov.io/v2/domain-search/prospects/search-emails/result/5e846a1d80d95f66cfb30250a7c1881f"
  }
}
Parâmetros de saída
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou.
result
URL da sua próxima solicitação de recuperar o e-mail do cliente potencial.
E-mail do cliente potencial (obter resultados)
URL recebido da sua solicitação anterior.
GEThttps://api.snov.io/v2/domain-search/prospects/search-emails/result/{task_hash}
Exemplos de código
<?php
function searchProspectEmailsResult()
{
    $token = getAccessToken();

    $task_hash = '5e846a1d80d95f66cfb30250a7c1881f';
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/prospects/search-emails/result/$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def search_prospect_emails_result():
token = get_access_token()
task_hash = '7f1df5bd8bca6f66e38dad0ffb30ba4c'
headers = {'authorization': f'Bearer {token}'}

res = requests.get(f'https://api.snov.io/v2/domain-search/prospects/search-emails/result/{task_hash}', headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": {
    "searching_date": "2025-01-01 11:11:11",
    "emails": [
      {
        "email": "example@snov.io",
        "smtp_status": "valid"
      }
    ]
  },
  "meta": {
    "task_hash": "5e846a1d80d95f66cfb30250a7c1881f"
  },
  "links": [],
  "status": "completed"
}
Parâmetros de saída
searching_date
Data em que o e-mail foi pesquisado.
emails
E-mails de cliente potencial.
smtp_status
Pode retornar valid ou unknown (também conhecido como "Não verificável"). Você pode saber mais sobre status de e-mails aqui.
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou.
status
Status da solicitação. Pode ser completed ou in progress.
E-mails de domínio (solicitar resultados)
1 crédito por solicitação distinta.
POSThttps://api.snov.io/v2/domain-search/domain-emails/start
Parâmetros de entrada
domain
O nome do domínio da empresa para o qual você deseja localizar e-mails de domínio. Por exemplo, "snov.io".
Exemplos de código
<?php
function domainEmailsSearch()
{
    $token = getAccessToken();

    $params = [
        'domain' => 'snov.io',
    ];
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/domain-emails/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def domain_emails_search():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'domain': 'snov.io'
}

res = requests.post('https://api.snov.io/v2/domain-search/domain-emails/start', params=params, headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": [],
  "meta": {
    "domain": "snov.io",
    "tab": "emails",
    "task_hash": "36fce9ac2667a827f6c5ab954e288bed",
    "next": ""
  },
  "links": {
    "result": "https://api.snov.io/v2/domain-search/domain-emails/result/36fce9ac2667a827f6c5ab954e288bed"
  }
}
Parâmetros de saída
domain
Domínio para o qual você está recuperando e-mails.
tab
Exibe o tipo de resultados que você vai solicitar.

prospects indica que você está procurando perfis de clientes potenciais.

emails exibe e-mails de domínio.

service mostra que você vai receber e-mails genéricos.
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou. É adicionado automaticamente ao URL da sua próxima solicitação para receber os resultados.
next
ID para a solicitação da próxima página, se houver. Se não houver mais páginas disponíveis, ficará vazio.
result
URL de solicitação para você usar a fim de receber e-mails de domínio.
E-mails de domínio (obter resultados)
URL recebido da sua solicitação anterior.
GEThttps://api.snov.io/v2/domain-search/domain-emails/result/{task_hash}
Exemplos de código
<?php
function domainEmailsResult()
{
    $token = getAccessToken();

    $task_hash = '36fce9ac2667a827f6c5ab954e288bed';
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/domain-emails/result/$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def domain_emails_result():
token = get_access_token()
task_hash = '36fce9ac2667a827f6c5ab954e288bed'
headers = {'authorization': f'Bearer {token}'}

res = requests.get(f'https://api.snov.io/v2/domain-search/domain-emails/result/{task_hash}', headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": [
    {
      "email": "admin@snov.io"
    },
    {
      "email": "help@snov.io"
    }
  ],
  "meta": {
    "domain": "snov.io",
    "tab": "emails",
    "task_hash": "36fce9ac2667a827f6c5ab954e288bed",
    "next": "4ae6ca51c056c584db03c618dfe80dedb82ec37ab4667fa189386c82288a7422e8f4ab1010d84a13f2728d8f1b12b2ff139e3cb81108dc48",
    "total_count": 108
  },
  "links": {
    "next": "https://api.snov.io/v2/domain-search/domain-emails/start?domain=snov.io&next=4ae6ca51c056c584db03c618dfe80dedb82ec37ab4667fa189386c82288a7422e8f4ab1010d84a13f2728d8f1b12b2ff139e3cb81108dc48"
  },
  "status": "completed"
}
Parâmetros de saída
email
Endereço de e-mail do domínio.

Atenção: esses e-mails não são verificados. Para verificá-los, use o método Verificador de e-mails.
domain
Domínio para o qual você está recuperando e-mails.
tab
Exibe o tipo de resultados que você vai receber.

prospects indica que você está procurando perfis de clientes potenciais.

emails exibe e-mails de domínio.

service mostra que você vai receber e-mails genéricos.
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou.
next
ID adicionado ao URL de solicitação para acessar a próxima página de e-mails caso ela exista.
total_count
Número total de e-mails de domínio encontrados.
next
URL da solicitação de obter os resultados da página a seguir, caso exista. Cada página tem até 50 e-mails.
status
Status da solicitação. Pode ser completed ou in progress.
Contatos genéricos (solicitar resultados)
1 crédito por solicitação distinta.
POSThttps://api.snov.io/v2/domain-search/generic-contacts/start
Parâmetros de entrada
domain
O nome do domínio da empresa para o qual você deseja localizar e-mails genéricos. Por exemplo, "snov.io".
Exemplos de código
<?php
function genericContactsSearch()
{
    $token = getAccessToken();

    $params = [
        'domain' => 'snov.io',
    ];
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/generic-contacts/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def generic_contacts_search():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'domain': 'snov.io'
}

res = requests.post('https://api.snov.io/v2/domain-search/generic-contacts/start', params=params, headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": [],
  "meta": {
    "domain": "snov.io",
    "tab": "service",
    "task_hash": "0e36e43b9b91a9b20d14b82c1ee141f2",
    "next": ""
  },
  "links": {
    "result": "https://api.snov.io/v2/domain-search/generic-contacts/result/0e36e43b9b91a9b20d14b82c1ee141f2"
  }
}
Parâmetros de saída
domain
Domínio para o qual você está recuperando e-mails genéricos.
tab
Exibe o tipo de resultados que você vai solicitar.

prospects indica que você está procurando perfis de clientes potenciais.

emails exibe e-mails de domínio.

service mostra que você vai receber e-mails genéricos.
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou. É adicionado automaticamente ao URL da sua próxima solicitação para receber os resultados.
next
ID para a solicitação da próxima página, se houver. Se não houver mais páginas disponíveis, ficará vazio.
result
URL de solicitação para você usar a fim de receber e-mails genéricos.
Contatos genéricos (obter resultados)
URL recebido da sua solicitação anterior.
GEThttps://api.snov.io/v2/domain-search/generic-contacts/result/{task_hash}
Exemplos de código
<?php
function genericContactsResult()
{
    $token = getAccessToken();

    $task_hash = '0e36e43b9b91a9b20d14b82c1ee141f2';
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/generic-contacts/result/$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def generic_contacts_result():
token = get_access_token()
task_hash = '0e36e43b9b91a9b20d14b82c1ee141f2'
headers = {'authorization': f'Bearer {token}'}

res = requests.get(f'https://api.snov.io/v2/domain-search/generic-contacts/result/{task_hash}', headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": [
    {
      "email": "orders@snov.io"
    },
    {
      "email": "sales@snov.io"
    }
  ],
  "meta": {
    "domain": "snov.io",
    "tab": "service",
    "task_hash": "0e36e43b9b91a9b20d14b82c1ee141f2",
    "next": "",
    "total_count": 9
  },
  "links": {
    "next": ""
  },
  "status": "completed"
}
Parâmetros de saída
email
Endereço de e-mail do contato genérico.

Atenção: esses e-mails não são verificados. Para verificá-los, use o método Verificador de e-mails.
domain
Domínio para o qual você está recuperando e-mails genéricos.
tab
Exibe o tipo de resultados que você vai receber.

prospects indica que você está procurando perfis de clientes potenciais.

emails exibe e-mails de domínio.

service mostra que você vai receber e-mails genéricos.
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou.
next
ID adicionado ao URL de solicitação para acessar a próxima página de e-mails caso ela exista.
total_count
Número total de e-mails genéricos encontrados para o domínio.
next
URL da solicitação de obter os resultados da página a seguir, caso exista. Cada página tem até 50 e-mails.
status
Status da solicitação. Pode ser completed ou in progress.

POSTContagem de emails

Gratuito

Com este método de API, você pode descobrir o número de endereços de email de um determinado domínio em nosso banco de dados. É totalmente gratuito, então você não precisa de créditos para usá-lo!

Solicitação
POSThttps://api.snov.io/v1/get-domain-emails-count
Parâmetros de entrada
domain
O nome do domínio para o qual você gostaria de saber o número de emails em nosso banco de dados.
Exemplos de código
<?php
function getEmailCount()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'domain'       => 'octagon.com',
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-domain-emails-count',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def get_email_count():
token = get_access_token()
params = {'access_token':token,
        'domain':'octagon.com'

}

res = requests.post('https://api.snov.io/v1/get-domain-emails-count', data=params)

return json.loads(res.text)
Exemplo de resposta
{
"success":true,
"domain":"octagon.com",
"webmail":false,
"result":1369
}
Parâmetros de saída
domain
O nome do domínio para o qual você gostaria de saber o número de emails em nosso banco de dados.
webmail
É
true
se o domínio que você está pesquisando for um webmail.
result
Um número total de endereços de email que encontramos para este domínio. Como não podemos fornecer resultados para domínios de webmail, o resultado do webmail será sempre
0
.

POSTLocalizador de emails

Gratuito

Este método de API localiza endereços de email usando o nome e o sobrenome da pessoa, e um nome de domínio. Se não tivermos esse endereço de email em nosso banco de dados, não poderemos fornecer os resultados imediatamente. Para acelerar o processo, você pode usar o Adicionar nomes para localizar emails método para enviar este endereço de email para pesquisa. Depois disso, tente o método do localizador de emails novamente.

Limites: Se você enviar muitas solicitações em uma hora poderá ver a seguinte mensagem de erro: "There are too many prospects processing. Please try later"
Os limites de pesquisa por hora dependem do seu plano:

  • Starter - 200 solicitações/hora
  • Pro 5K - 400 solicitações/hora
  • Pro 20K - 600 solicitações/hora
  • Pro 50K - 800 solicitações/hora
  • Pro 100K - 1.000 solicitações/hora
Solicitação
POSThttps://api.snov.io/v1/get-emails-from-names
Parâmetros de entrada
firstName
O nome do proprietário do endereço de email.
lastName
O sobrenome do proprietário do endereço de email.
domain
O nome do domínio da empresa que é usado no endereço de email.
Exemplos de código
<?php
function getEmailFinder()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'domain'       => 'octagon.com',
        'firstName'    => 'gavin',
        'lastName'     => 'vanrooyen'
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-emails-from-names',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def get_email_finder():
token = get_access_token()
params = {'access_token':token,
          'domain':'octagon.com',
          'firstName': 'gavin',
          'lastName':'vanrooyen'
}

res = requests.post('https://api.snov.io/v1/get-emails-from-names', data=params)

return json.loads(res.text)
Exemplo de resposta
{
"success":true,
"params":{
"firstName":"gavin",
"lastName":"vanrooyen",
"domain":"octagon.com"
},
"data":{
"firstName":"gavin",
"lastName":"vanrooyen",
"emails":[
{
"email":"Gavin@octagon.com",
"emailStatus":"valid"
}
]
},
"status":{
"identifier":"complete",
"description":"Emails search is completed"
}
}
Parâmetros de saída
status
Use os valores neste objeto para detectar o status do processo.
identifier
Pode conter os seguintes valores:
complete
,
in_progress
, ou
not_found
 . Se o identificador for
not_found
 , a resposta conterá uma série de emails vazios.
description
Aqui, você verá uma descrição do texto do status de localização de email.
data
Contém o resultado da pesquisa.
firstName
O nome do proprietário do endereço de email.
lastName
O sobrenome do proprietário do endereço de email.
emails
A série de endereços de email com seus status. Valor
emailStatus
pode conter:
valid
ou
unknown
.

POSTAdicionar nomes para localizar emails

1 crédito por solicitação

Se a Snov.io não tiver os emails que você procura em seu banco de dados e não puder fornecer esses endereços por meio do Localizador de emails, você pode tentar enviar a solicitação de pesquisa de emails usando esse método. Se um email for encontrado, você poderá coletá-lo usando o aplicativo gratuito Localizador de emails solicitar novamente.

Limites: Se você enviar muitas solicitações em uma hora poderá ver a seguinte mensagem de erro: "There are too many prospects processing. Please try later"
Os limites de pesquisa por hora dependem do seu plano:

  • Starter - 200 solicitações/hora
  • Pro 5K - 400 solicitações/hora
  • Pro 20K - 600 solicitações/hora
  • Pro 50K - 800 solicitações/hora
  • Pro 100K - 1.000 solicitações/hora
Solicitação
POSThttps://api.snov.io/v1/add-names-to-find-emails
Parâmetros de entrada
firstName
O nome do proprietário do endereço de email.
lastName
O sobrenome do proprietário do endereço de email.
domain
O nome do domínio da empresa que é usado no endereço de email.
Exemplos de código
<?php
function getAddNamesToFindEmails()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'domain'       => 'octagon.com',
        'firstName'    => 'gavin',
        'lastName'     => 'vanrooyen'
    ];


    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/add-names-to-find-emails',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def add_names_to_find_emails():
token = get_access_token()
params = {'access_token':token,
          'domain':'octagon.com',
          'firstName': 'gavin',
          'lastName':'vanrooyen'
}

res = requests.post('https://api.snov.io/v1/add-names-to-find-emails', data=params)

return json.loads(res.text)
Exemplo de resposta
{
"success":true,
"firstName":"gavin",
"lastName":"vanrooyen",
"domain":"octagon.com",
"userId":666871,
"sent":true
}

Se uma solicitação de email for adicionada com êxito à fila, o método retornará "sent":true.

POSTAdicionar URL para buscar cliente potencial

1 crédito por solicitação

Encontre clientes potenciais pela URL de rede social. Para receber os resultados, use o método Obter cliente potencial com URL.

Solicitação
POSThttps://api.snov.io/v1/add-url-for-search
Parâmetros de entrada
url
Um link para o perfil de mídias sociais do cliente potencial. Especifique o nome da rede social entre [colchetes] (LinkedIn ou X).
Exemplos de código
<?php
function addUrlForSearch()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'url'          => 'https://www.linkedin.com/in/johndoe/&social'
    ];


    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/add-url-for-search',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def add_url_for_search():
token = get_access_token()
params = {'access_token':token,
          'url':'https://www.linkedin.com/in/elie-ohayon-aaab7341'
}

res = requests.post('https://api.snov.io/v1/add-url-for-search', data=params)

return json.loads(res.text)
Exemplo de resposta
{
  "success": true
}
Parâmetros de saída
success
É
true
se o cliente potencial foi adicionado à lista de busca.
message
Houve um erro ao adicionar o cliente potencial à lista.

POSTObter cliente potencial com URL

Gratuito

Forneça a URL de rede social do cliente potencial, e a Snov.io retornará as informações completas dele com os endereços de email encontrados. Para isso, é preciso usar antes o método Adicionar URL para buscar cliente potencial. Do contrário, o resultado não será exibido.

Solicitação
POSThttps://api.snov.io/v1/get-emails-from-url
Parâmetros de entrada
url
Um link para o perfil de mídias sociais do cliente potencial. Especifique o nome da rede social entre [colchetes] (LinkedIn ou X).
Exemplos de código
<?php
function getEmailsFromUrl()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'url'          => 'https://www.linkedin.com/in/john-doe-123456/'
    ];


    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-emails-from-url',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def get_emails_from_url():
token = get_access_token()
params = {'access_token':token,
          'url':'https://www.linkedin.com/in/elie-ohayon-aaab7341'
}

res = requests.post('https://api.snov.io/v1/get-emails-from-url', data=params)

return json.loads(res.text)
Exemplo de resposta
{
  "success": true,
  "data": [
    {
      "id": "xusD3-T_K5IktGoaa8Jc8A==",
      "name": "Gavin Vanrooyen",
      "firstName": "John",
      "lastName": "Doe",
      "sourcePage": "https://www.linkedin.com/in/john-doe-123456/",
      "source": "linkedIn",
      "industry": "Entertainment",
      "country": "United States",
      "locality": "Greater Atlanta Area",
      "lastUpdateDate": {
        "date": "2019-09-11 12:37:58.000000",
        "timezone_type": 3,
        "timezone": "UTC"
      },
      "currentJob": [
        {
          "companyName": "Octagon",
          "position": "Senior Brand Director",
          "socialLink": "https:\/\/www.linkedin.com\/company\/659333",
          "site": "http:\/\/octagon.com",
          "locality": "United States",
          "state": null,
          "city": null,
          "street": null,
          "street2": null,
          "postal": null,
          "founded": null,
          "startDate": "2018-07-31",
          "endDate": null,
          "size": "1-10",
          "industry": "Entertainment",
          "companyType": "Public Company",
          "country": "United States"
        }
      ],
      "previousJob": [
        {
          "companyName": "UPS",
          "position": "Manager, Sponsorships and Events",
          "socialLink": "https:\/\/www.linkedin.com\/company\/1523574",
          "site": "http:\/\/www.ups.com\/",
          "locality": "United States",
          "state": "GA",
          "city": "Atlanta",
          "street": "55 Glenlake Parkway, NE",
          "street2": null,
          "postal": "30328",
          "founded": "1907",
          "startDate": null,
          "endDate": null,
          "size": "10001+",
          "industry": "Logistics and Supply Chain",
          "companyType": "Public Company",
          "country": "United States"
        }
      ],
        "social": [],
        "emails": [
            {
                "email": "johndoe@octagon.com",
                "status": "valid"
            }
        ]
    }
  ]
}
Parâmetros de saída
success
É
true
se o cliente potencial foi encontrado
id
Identificador de perfil único
name
Nome completo do cliente potencial
firstName
Nome do cliente potencial
lastName
Sobrenome do cliente potencial
industry
Setor confirme indicado no perfil do cliente potencial
country
País do cliente potencial
locality
Local do cliente potencial
skills
Habilidades do cliente potencial
social
Links para os perfis sociais do cliente potencial
currentJobs
A série contém informações sobre o cargo atual do cliente potencial
previousJobs
A série contém informações sobre os cargos anteriores do cliente potencial
lastUpdateDate
Data da última atualização do perfil
emails
E-mail do cliente potencial com status real

POSTObter perfil com email

1 crédito por solicitação

Forneça um endereço de email e a Snov.io retornará todas as informações de perfil conectadas ao proprietário do endereço de email fornecido a partir do banco de dados.

Se não encontrarmos informações sobre o proprietário do email em nosso banco de dados, você não será cobrado pela solicitação.

Solicitação
POSThttps://api.snov.io/v1/get-profile-by-email
Parâmetros de entrada
email
O endereço de email da pessoa para a qual você deseja encontrar informações adicionais.
Exemplos de código
<?php
function getProfileByEmail()
{
    $token = getAccessToken();

    $params = [
        'access_token'    => $token,
        'email'           => 'gavin.vanrooyen@octagon.com'
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-profile-by-email',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);
    
    return $res;

}
?>
def get_profile_by_email():
token = get_access_token()
params = {'access_token':token,
        'email':'gavin.vanrooyen@octagon.com'
}

res = requests.post('https://api.snov.io/v1/get-profile-by-email', data=params)

return json.loads(res.text)
Exemplo de resposta
{
"success": true,
"id": 301592,
"source": "linkedIn",
"name": "Lizi Hamer",
"firstName": "Lizi",
"lastName": "Hamer",
"logo": "https://app.snov.io/img/peoples/010fcf23c70dfa68d880545ec89a9215.jpg",
"industry": null,
"country": "Singapore",
"locality": "Singapore",
"social": [
    {
        "link": "https://www.linkedin.com/in/lizihamer/",
        "type": "linkedIn"
    },
    {
        "link": "https://twitter.com/LiziHamer",
        "type": "twitter"
    }
],
"currentJobs": [
    {
        "companyName": "Octagon",
        "position": "Regional Creative Director",
        "socialLink": "https://www.linkedin.com/company/165282",
        "site": "www.octagon.com",
        "locality": "Greater New York City Area",
        "state": "Connecticut",
        "city": "Stamford",
        "street": "290 Harbor Dr",
        "street2": "2nd Floor",
        "postal": "06902",
        "founded": "1983",
        "startDate": "2016-01-31",
        "endDate": null,
        "size": "1-10",
        "industry": "Marketing and Advertising",
        "companyType": "Public Company",
        "country": "United States"
    },
    {
        "companyName": "SisuGirls",
        "position": "Co Founder",
        "socialLink": "https://www.linkedin.com/company/3841118",
        "site": "http://www.sisugirls.org",
        "locality": null,
        "state": "SG",
        "city": "Singapore",
        "street": "33-03 Hong Leong Building",
        "street2": null,
        "postal": null,
        "founded": "2014",
        "startDate": "2015-07-31",
        "endDate": null,
        "size": "1-10",
        "industry": "Health, Wellness and Fitness",
        "companyType": null,
        "country": "Singapore"
    }
],
"previousJobs": [
    {
        "companyName": "Fusion Co-innovation Labs",
        "position": "Creative Entrepreneur",
        "socialLink": null,
        "site": null,
        "locality": null,
        "state": null,
        "city": null,
        "street": null,
        "street2": null,
        "postal": null,
        "founded": null,
        "startDate": "2013-05-31",
        "endDate": "2013-10-31",
        "size": null,
        "industry": null,
        "companyType": null,
        "country": null
    },
    {
        "companyName": "Russell Commission",
        "position": "Youth Advisory Board Member",
        "socialLink": null,
        "site": null,
        "locality": null,
        "state": null,
        "city": null,
        "street": null,
        "street2": null,
        "postal": null,
        "founded": null,
        "startDate": "2004-06-30",
        "endDate": "2006-06-30",
        "size": null,
        "industry": null,
        "companyType": null,
        "country": null
    }
],
"lastUpdateDate": "2018-02-07 10:12:28"
}
Parâmetros de saída
id
Um identificador de perfil exclusivo.
source
A fonte dos dados pessoais recuperados.
name
O nome completo do proprietário do endereço de email.
firstName
O nome da pessoa.
lastName
O sobrenome da pessoa.
logo
A foto do perfil da pessoa.
industry
O setor da pessoa conforme indicado na fonte.
country
O país da pessoa conforme indicado na fonte.
locality
O local da pessoa conforme indicado na fonte.
social
Links para os perfis sociais da pessoa.
currentJobs
Uma matriz contendo informações sobre os cargos atuais da pessoa.
previousJobs
Uma matriz contendo informações sobre os cargos anteriores da pessoa.
lastUpdateDate
A data da última atualização do perfil no banco de dados.

POSTVerificar e-mails

Insira endereços de e-mail, e a Snov.io realizará uma verificação completa. Você pode verificar até 10 e-mails ao mesmo tempo.

Fornecendo e-mails

POSThttps://api.snov.io/v2/email-verification/start
Parâmetros de entrada
emails[]
E-mails que você deseja verificar.
Para recuperar domínios para várias empresas, adicione cada uma como um parâmetro separado. Por exemplo:
emails[] | help@snov.io
emails[] | partnerships@snov.io
Você pode fornecer até 10 nomes de empresas ao mesmo tempo.
webhook_url
Insira seu URL de webhook para receber os resultados instantaneamente em vez de usar uma tarefa de hash.
Exemplos de código
<?php
function emailVerificationStart()
{
    $token = getAccessToken();

    $params = [
        'emails'    => ['gavin.vanrooyen@octagon.com','lizi.hamer@octagon.com','admin@snov.io','test@snov.io','ivalid_format_snov.io'],
        'webhook_url'         => 'https://hooks.yourdomain.com',
    ];

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/email-verification/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query($params),
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def email_verification_start():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'emails[]': ['gavin.vanrooyen@octagon.com', 'lizi.hamer@octagon.com', 'admin@snov.io', 'test@snov.io', 'ivalid_format_snov.io'],
  'webhook_url': 'https://hooks.yourdomain.com',
}
res = requests.post('https://api.snov.io/v2/email-verification/start', params=params, headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": {
    "task_hash": "0110437df6811068197577a538849a4b"
  },
  "meta": {
    "emails": [
      "gavin.vanrooyen@octagon.com",
      "lizi.hamer@octagon.com",
      "admin@snov.io",
      "test@snov.io",
      "ivalid_format_snov.io"
    ]
  }
}
Parâmetros de saída
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou.
emails
Uma matriz de e-mails que você forneceu para verificação.
Recebendo resultados da verificação
GEThttps://api.snov.io/v2/email-verification/result
Parâmetros de entrada
task_hash
ID de solicitação exclusivo que você recebeu da solicitação anterior.
Exemplos de código
<?php
function emailVerificationResult()
{
    $token = getAccessToken();

    $task_hash = '0110437df6811068197577a538849a4b';

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/email-verification/result?task_hash=$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def email_verification_result():
token = get_access_token()
task_hash = 'b55b28d5419a1c3ec310f21916e4e271'
headers = {'authorization': f'Bearer {token}'}
params = {
  'task_hash': task_hash
}

res = requests.get(f'https://api.snov.io/v2/email-verification/result', params=params, headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "status": "completed",
  "data": [
    {
      "email": "gavin.vanrooyen@octagon.com",
      "result": {
        "is_webmail": false,
        "smtp_status": "unknown",
        "is_gibberish": false,
        "is_disposable": false,
        "is_valid_format": true,
        "unknown_status_reason": "catchall"
      }
    },
    {
      "email": "admin@snov.io",
      "result": {
        "is_webmail": false,
        "smtp_status": "valid",
        "is_gibberish": false,
        "is_disposable": false,
        "is_valid_format": true
      }
    },
    {
      "email": "ivalid_format_snov.io",
      "result": {
        "is_webmail": false,
        "smtp_status": "not_valid",
        "is_gibberish": false,
        "is_disposable": false,
        "is_valid_format": false
      }
    },
    {
      "email": "lizi.hamer@octagon.com",
      "result": {
        "is_webmail": false,
        "smtp_status": "unknown",
        "is_gibberish": false,
        "is_disposable": false,
        "is_valid_format": true,
        "unknown_status_reason": "catchall"
      }
    },
    {
      "email": "test@snov.io",
      "result": {
        "smtp_status": "unknown",
        "is_valid_format": true,
        "is_disposable": false,
        "is_webmail": false,
        "is_gibberish": true,
        "unknown_status_reason": "banned"
      }
    }
  ],
  "meta": {
    "emails": [
      "gavin.vanrooyen@octagon.com",
      "lizi.hamer@octagon.com",
      "admin@snov.io",
      "test@snov.io",
      "ivalid_format_snov.io"
    ],
    "task_hash": "0110437df6811068197577a538849a4b"
  }
}
Parâmetros de saída
status
Status da solicitação. Pode ser completed ou in_progress.
email
Endereço de e-mail que você está verificando.
smtp_status
Pode retornar valid, not_valid ou unknown (também conhecido como "Não verificável").
Para ver o motivo do status unknown, verifique o parâmetro unknown_status_reason.
is_valid_format
Mostra se o formato do e-mail é válido. Pode ser false ou true.
is_disposable
Indica se um e-mail é temporário ou descartável, retornando false ou true.
is_webmail
É true se o e-mail que você está pesquisando for um webmail.
is_gibberish
Mostra se o endereço de e-mail fornecido contém caracteres aleatórios ou sem sentido. Será false ou true.
unknown_status_reason
Se um e-mail verificado tiver um smtp_status desconhecido, você poderá encontrar um motivo mais detalhado aqui.
Banned: alto risco de capacidade de entrega. Não foi possível verificar este e-mail com 100% de certeza.
Catchall: risco à reputação do remetente. Este e-mail é genérico.
Connection_error: possível risco de devolução. Problemas técnicos no lado do destinatário.
Greylist: risco à capacidade de entrega. Este servidor de e-mail usa filtros de lista cinza.
Hidden_by_owner: o proprietário do e-mail ou a empresa que possui o domínio solicitou sua remoção dos resultados da Snov.io.
emails
Uma matriz de e-mails que você está verificando.
task_hash
ID de solicitação exclusivo para esta tarefa de verificação.

POSTEncontrar domínio a partir do nome da empresa

1 crédito para cada endereço de domínio encontrado

Insira nomes de empresas, e a Snov.io retornará os respectivos endereços de domínio.

Fornecendo nomes de empresas
POSThttps://api.snov.io/v2/company-domain-by-name/start
Parâmetros de entrada
names[]
Uma matriz de nomes de empresas para as quais você deseja receber os domínios.
Para recuperar domínios para várias empresas, adicione cada uma como um parâmetro separado. Por exemplo:
names[] | Snov.io
names[] | Sendpulse
Você pode fornecer até 10 nomes de empresas ao mesmo tempo.
webhook_url
Insira seu URL de webhook para receber os resultados instantaneamente em vez de usar uma tarefa de hash.
Exemplos de código
<?php
function companyDomainByNameStart()
{
    $token = getAccessToken();

    $params = [
        'names'    => ['Snov.io','SendPulse'],
        'webhook_url'         => 'https://hooks.yourdomain.com',
    ];

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/company-domain-by-name/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query($params),
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def company_domain_by_name_start():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'webhook_url': 'https://hooks.yourdomain.com',
  'names[]': ['Snov.io', 'Sendpulse']
}

res = requests.post('https://api.snov.io/v2/company-domain-by-name/start', params=params, headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": {
    "task_hash": "959c0f60facb8629bba746e091a26f7b"
  },
  "meta": {
    "names": [
      "Snov.io",
      "Sendpulse"
    ]
  }
}
Parâmetros de saída
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou.
names
Uma matriz de nomes de empresas que você forneceu.
Recebendo domínios de empresas
GEThttps://api.snov.io/v2/company-domain-by-name/result?task_hash={hash_from_1}
Parâmetros de entrada
task_hash
ID de solicitação exclusivo que você recebeu da solicitação anterior.
Exemplos de código
<?php
function companyDomainByNameResult()
{
    $token = getAccessToken();

    $task_hash = '48c156a785cfc1f3b0edab2cc28b3774';

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/company-domain-by-name/result?task_hash=$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def company_domain_by_name_result():
token = get_access_token()
task_hash = '959c0f60facb8629bba746e091a26f7b'
headers = {'authorization': f'Bearer {token}'}
params = {
  'task_hash': task_hash
}

res = requests.get(f'https://api.snov.io/v2/company-domain-by-name/result', params=params, headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "status": "completed",
  "data": [
    {
      "name": "Snov.io",
      "result": {
        "domain": "snov.io"
      }
    },
    {
      "name": "Sendpulse",
      "result": {
        "domain": "sendpulse.com"
      }
    }
  ],
  "meta": {
    "names": [
      "Snov.io",
      "Sendpulse"
    ],
    "task_hash": "959c0f60facb8629bba746e091a26f7b"
  }
}
Parâmetros de saída
status
Status da solicitação. Pode ser completed ou in_progress.
name
Nome da empresa para a qual você solicitou um endereço de domínio.
domain
Domínio da empresa.
names
Uma matriz de nomes de empresas que você forneceu.
task_hash
ID exclusivo para esta tarefa de pesquisa.

POSTObter informações do perfil do LinkedIn a partir de URLs

1 crédito por informação de perfil de cliente potencial fornecida

Insira os URLs dos membros do LinkedIn, e a Snov.io recuperará todas as informações dos perfis deles.

Fornecendo URLs do LinkedIn
POSThttps://api.snov.io/v2/li-profiles-by-urls/start
Parâmetros de entrada
urls[]
Uma matriz de URLs de perfis do LinkedIn para os quais você deseja receber as informações completas do perfil.
Para recuperar informações de perfil de vários membros do LinkedIn ao mesmo tempo, adicione cada URL em um parâmetro separado.
Você pode fornecer até 10 URLs do LinkedIn ao mesmo tempo.
webhook_url
Insira seu URL de webhook para receber os resultados instantaneamente em vez de usar uma tarefa de hash.
Exemplos de código
<?php
function linkedInProfilesByUrlsStart()
{
    $token = getAccessToken();

    $params = [
        'urls'    => ['https://www.linkedin.com/in/oleksii-kratko-6a0544187/','https://www.linkedin.com/in/atahualpamaia/'],
        'webhook_url'         => 'https://hooks.yourdomain.com',
    ];

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/li-profiles-by-urls/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query($params),
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def linkedin_profiles_by_urls_start():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'urls[]': ['https://www.linkedin.com/in/atahualpamaia/', 'https://www.linkedin.com/in/oleksii-kratko-6a0544187/'],
  'webhook_url': 'https://hooks.yourdomain.com',
}

res = requests.post('https://api.snov.io/v2/li-profiles-by-urls/start', params=params, headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "data": {
    "task_hash": "ef005a4f6d82e7e88384de7c72ee198d"
  },
  "meta": {
    "urls": [
      "https://www.linkedin.com/in/john-doe-32a416248/",
      "https://www.linkedin.com/in/john-doe-04bb56b1/",
      "https://www.linkedin.com/in/john-jungwoo-do/"
    ]
  }
}
Parâmetros de saída
task_hash
ID exclusivo para a tarefa de pesquisa que você iniciou.
urls
URLs de perfil para os quais você está solicitando as informações.
Recebendo informações de perfil
GEThttps://api.snov.io/v2/li-profiles-by-urls/result
Parâmetros de entrada
task_hash
ID de solicitação exclusivo que você recebeu da solicitação anterior.
Exemplos de código
<?php
function linkedInProfilesByUrlsResult()
{
    $token = getAccessToken();

    $task_hash = 'ef005a4f6d82e7e88384de7c72ee198d';

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/li-profiles-by-urls/result?task_hash=$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def linkedin_profiles_by_urls_result():
token = get_access_token()
task_hash = '879788bd889b0b9aa447278ce184e2ad'
headers = {'authorization': f'Bearer {token}'}
params = {
  'task_hash': task_hash
}

res = requests.get(f'https://api.snov.io/v2/li-profiles-by-urls/result', params=params, headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
  "status": "completed",
  "data": [
    {
      "url": "https://www.linkedin.com/in/john-doe-32a416248/",
      "result": {
        "name": "John Doe",
        "first_name": "John",
        "last_name": "Doe",
        "industry": "Internet",
        "location": "Chicago, Illinois, United States",
        "country": "United States",
        "positions": [
          {
            "name": "Stealth Startup",
            "title": "CEO",
            "linkedin_url": "https://www.linkedin.com/company/18583501",
            "url": "https://www.linkedin.com/in/ruhbirsingh/",
            "industry": "Computer Software",
            "country": "India",
            "location": "Gurugram, Haryana, India"
          },
          {
            "name": "TikTok",
            "title": "Influencer",
            "linkedin_url": "https://www.linkedin.com/company/33246798",
            "url": "https://www.tiktok.com/about?lang=en",
            "industry": "Entertainment",
            "country": "United States",
            "location": "Los Angeles, California, United States"
          }
        ]
      }
    },
    {
      "url": "https://www.linkedin.com/in/john-doe-04bb56b1/",
      "result": []
    },
    {
      "url": "https://www.linkedin.com/in/john-jungwoo-do/",
      "result": {
        "name": "John Do",
        "first_name": "John",
        "last_name": "Do",
        "location": "Vancouver, British Columbia, Canada",
        "country": "Canada",
        "skills": [
          "communication",
          "java"
        ],
        "positions": [
          {
            "name": "UBC Electrical and Computer Engineering",
            "title": "Undergraduate Research Assistant",
            "linkedin_url": "https://www.linkedin.com/company/15134449",
            "url": "http://www.ece.ubc.ca",
            "industry": "Higher Education",
            "country": "Canada",
            "location": "Vancouver, British Columbia, Canada"
          },
          {
            "name": "The University of British Columbia",
            "title": "Undergraduate Teaching Assistant",
            "linkedin_url": "https://www.linkedin.com/company/4373",
            "url": "http://www.ubc.ca",
            "industry": "Higher Education",
            "country": "Canada",
            "location": "Vancouver, British Columbia, Canada",
            "specializations": [
              "Aboriginal Engagement",
              "Alumni Engagement",
              "Community Engagement",
              "Intercultural Understanding",
              "International Engagement",
              "Outstanding Work Environment",
              "Research Excellence",
              "Student Learning",
              "sustainability"
            ]
          }
        ]
      }
    },
    {
      "url": "https://www.linkedin.com/in/john-doe-474006162/",
      "result": []
    }
  ],
  "meta": {
    "urls": [
      "https://www.linkedin.com/in/john-doe-32a416248/",
      "https://www.linkedin.com/in/john-doe-04bb56b1/",
      "https://www.linkedin.com/in/john-jungwoo-do/",
      "https://www.linkedin.com/in/john-doe-474006162/"
    ],
    "task_hash": "8a60c72133d0ea94767e4a978355c630"
  }
}
Parâmetros de saída
status
Status da solicitação. Pode ser completed ou in_progress.
url
URL do perfil do LinkedIn.
name
Nome completo do cliente potencial.
first_name
Nome do cliente potencial.
last_name
Sobrenome do cliente potencial.
industry
Campo de atuação do cliente potencial.
location
Localização do cliente potencial.
country
País de base do cliente potencial, de acordo com o perfil do LinkedIn.
skills
Habilidades do cliente potencial.
positions
Matriz de cargos atualmente ocupados pelo cliente potencial.
name
O nome da empresa para a qual o cliente potencial está trabalhando.
title
Cargo do cliente potencial.
linkedin_url
Link para a página da empresa no LinkedIn.
url
Endereço do site da empresa.
industry
Setor da empresa.
country
País onde a sede da empresa está localizada.
location
Local da empresa.
specializations
Áreas de especialização ou foco da empresa.
urls
Uma matriz de URLs de perfis do LinkedIn que você forneceu.
task_hash
ID exclusivo para esta tarefa de pesquisa.

GETObter análises de campanha

Gratuito

Este método mostra as estatísticas da campanha com base nos filtros aplicados.

Solicitação
GEThttps://api.snov.io/v2/statistics/campaign-analytics
Parâmetros de entrada
campaign_id
O ID da campanha. Você pode encontrá-lo no URL ao visualizar as informações da campanha (exemplo). Se deixar este campo vazio, você receberá dados de todas as campanhas ativas dentro do período especificado.

Para obter dados de múltiplas campanhas, separe os IDs por vírgula.
sender_email
O ID da conta de e-mail de remetente. Você pode encontrá-lo no URL ao visualizar as informações da conta de e-mail (exemplo). Para ver análises de múltiplas contas de e-mail, separe os IDs por vírgula.

Ou deixe este parâmetro vazio se não quiser aplicar filtros de conta de e-mail.
sender_linkedin
O ID da conta de remetente do LinkedIn. Você pode encontrá-lo no URL ao visualizar ou editar as informações da conta do LinkedIn. Para ver análises de múltiplas contas, separe os IDs por vírgula.

Deixe este parâmetro vazio se não quiser aplicar filtros de conta do LinkedIn.
campaign_owner
Para ver dados de campanha para um membro específico da equipe, insira o respectivo endereço de e-mail. Para filtrar por múltiplos donos de campanhas, liste os endereços de e-mail separados por vírgula (sem espaços).

Exemplo: exemplo1@gmail.com,exemplo2@gmail.com

Observe que, para usar este filtro, sua conta precisa ter a permissão "Ver registros da equipe" ativada, e você precisa estar num plano Pro ou superior.
date_from
A data de início do período sobre o qual você deseja receber estatísticas. Formato: aaaa-mm-dd. Deixe vazio para receber as estatísticas desde sempre.
date_to
A data de fim do período sobre o qual você deseja receber estatísticas. Formato: aaaa-mm-dd. Deixe vazio para receber as estatísticas desde sempre.
Exemplos de código

<?php

function getCampaignAnalytics()

{

   $token = getAccessToken();

   $campaignIds = [1, 2];

   $senderEmailIds = [21, 22];

   $senderLinkedInIds = [31, 32, 33];

   $ownerEmails = ['owner1@email.loc', 'owner2@email.loc'];

   $params = [

       'access_token' => $token,

       'campaign_id' => implode(',', $campaignIds),

       'sender_email' => implode(',', $senderEmailIds),

       'sender_linkedin' => implode(',', $senderLinkedInIds),

       'campaign_owner' => implode(',', $ownerEmails),

       'date_from' => '2024-06-15',

       'date_to' => '2024-09-15',

   ];

   $params = http_build_query($params);

   $options = [

       CURLOPT_URL => 'https://api.snov.io/v2/statistics/campaign-analytics?' . $params,

       CURLOPT_RETURNTRANSFER => true,

       CURLOPT_FOLLOWLOCATION => true

   ];

   $ch = curl_init();

   curl_setopt_array($ch, $options);

   $res = json_decode(curl_exec($ch), true);

   curl_close($ch);

   return $res;

}

?>

def get_campaign_analytics():

   token = get_access_token()

   campaign_ids = [1, 2]

   sender_email_ids = [21, 22]

   sender_linkedin_ids = [31, 32, 33]

   owner_emails = ['owner1@email.loc', 'owner2@email.loc']

   params = {

       'access_token': token,

       'campaign_id': ','.join(map(str, campaign_ids)),

       'sender_email': ','.join(map(str, sender_email_ids)),

       'sender_linkedin': ','.join(map(str, sender_linkedin_ids)),

       'campaign_owner': ','.join(owner_emails),

       'date_from': '2024-06-15',

       'date_to': '2024-09-15',

   }

   res = requests.get('https://api.snov.io/v2/statistics/campaign-analytics', params=params)

   return json.loads(res.text)

Exemplo de resposta
{
    "total_contacted": 32,
    "emails_sent": 31,
    "first_emails": 24,
    "first_emails_rate": "77%",
    "follow_ups": 7,
    "follow_ups_rate": "23%",
    "delivered": 30,
    "delivered_rate": "97%",
    "bounced": 1,
    "bounced_rate": "3%",
    "contacted_by_email": 23,
    "email_opens": 16,
    "email_opens_rate": "70%",
    "link_clicks": 0,
    "link_clicks_rate": "0%",
    "email_replies": 16,
    "email_replies_rate": "70%",
    "unsubscribed": 0,
    "unsubscribed_rate": "0%",
    "auto_replied": 0,
    "auto_replied_rate": "0%",
    "contacted_by_linkedin": 10,
    "linkedin_total_replies": 9,
    "linkedin_total_replies_rate": "90%",
    "connection_request_replies": 2,
    "connection_request_replies_rate": "22%",
    "message_replies": 7,
    "message_replies_rate": "78%",
    "in_mail_replies": 0,
    "in_mail_replies_rate": "0%",
    "connection_requests": 2,
    "accepted_requests": 2,
    "accepted_requests_rate": "100%",
    "failed_connection_requests": 0,
    "messages_sent": 9,
    "linkedin_views": 9,
    "linkedin_likes": 0,
    "linkedin_follows": 0,
    "in_mail_sent": 0,
    "interested": 8,
    "interested_rate": "32%",
    "maybe": 8,
    "maybe_rate": "32%",
    "not_interested": 4,
    "not_interested_rate": "16%"
}
Parâmetros de saída
total_contacted
Número total de destinatários que foram contatados por e-mail ou LinkedIn (solicitação de conexão, mensagem ou InMail).
emails_sent
Número total de e-mails enviados pelas campanhas.

Observe que não estão inclusos e-mails enviados fora de campanhas.
first_emails
Número de primeiros e-mails numa sequência de campanha enviados no período indicado.
first_emails_rate
Porcentagem de primeiros e-mails em relação ao total de e-mails enviados.
follow_ups
Número de e-mails de acompanhamento numa sequência de campanha enviados no período indicado.
follow_ups_rate
Porcentagem de e-mails de acompanhamento em relação ao total de e-mails enviados.
delivered
Número de e-mails enviados que não foram devolvidos.
delivered_rate
Porcentagem de e-mails que não foram devolvidos em relação ao total de e-mails enviados.
bounced
Número de e-mails que foram devolvidos.
bounced_rate
Porcentagem de e-mails que foram devolvidos em relação ao total de e-mails enviados.
contacted_by_email
Número de destinatários que receberam pelo menos um e-mail que não foi devolvido.
email_opens
Número de destinatários que abriram o seu e-mail pelo menos uma vez.
email_opens_rate
Porcentagem de destinatários que abriram o seu e-mail pelo menos uma vez em relação ao total de destinatários contatados.
link_clicks
Número de destinatários que clicaram em pelo menos um link nas suas campanhas.
link_clicks_rate
Porcentagem de destinatários que clicaram em pelo menos um link nas campanhas em relação ao total de destinatários contatados.
email_replies
Número de destinatários que responderam pelo menos uma vez.
email_replies_rate
Porcentagem de destinatários que responderam pelo menos uma vez em relação ao total de destinatários contatados.
unsubscribed
Número de destinatários que clicaram no Link de descadastro nas suas campanhas, optando por não receber mais e-mails.
unsubscribed_rate
Porcentagem de destinatários que clicaram no Link de descadastro nas suas campanhas em relação ao total de destinatários contatados.
auto_replied
Número de destinatários que responderam automaticamente aos e-mails da sua campanha.
auto_replied_rate
Porcentagem de destinatários que responderam automaticamente em relação ao total de destinatários contatados.
contacted_by_linkedin
Número de destinatários aos quais você enviou pelo menos uma mensagem ou solicitação de conexão no LinkedIn.
linkedin_total_replies
Número de destinatários que responderam a pelo menos uma das mensagens enviadas no LinkedIn (mensagens do LinkedIn, mensagens de solicitação de conexão e InMail).
linkedin_total_replies_rate
Porcentagem de destinatários que responderam a pelo menos uma das mensagens enviadas no LinkedIn (mensagens do LinkedIn, mensagens de solicitação de conexão e InMail).
connection_request_replies
Número de destinatários que responderam a uma mensagem de solicitação de conexão.
connection_request_replies_rate
Porcentagem de destinatários que responderam a uma mensagem de solicitação de conexão em relação ao total de destinatários contatados.
message_replies
Número de destinatários que responderam a uma mensagem normal do LinkedIn.
message_replies_rate
Porcentagem de destinatários que responderam a uma mensagem normal do LinkedIn em relação ao total de destinatários contatados.
in_mail_replies
Número de destinatários que responderam a uma mensagem de InMail do LinkedIn.
in_mail_replies_rate
Porcentagem de destinatários que responderam a uma mensagem de InMail do LinkedIn.
connection_requests
Número de solicitações de conexão enviadas a clientes potenciais por meio de campanhas da Snov.io.
accepted_requests
Número de solicitações de conexão que foram aceitas por membros do LinkedIn.
accepted_requests_rate
Porcentagem de solicitações de conexão que foram aceitas em relação a todas as solicitações enviadas.
failed_connection_requests
Número de solicitações de conexão do LinkedIn que não foram enviadas porque:
  • o URL do LinkedIn do cliente potencial não existe
  • você já enviou uma solicitação de conexão para esse cliente potencial, e ela está pendente
  • você já se conectou ao cliente potencial
messages_sent
Número de mensagens do LinkedIn enviadas.
linkedin_views
Número de perfis de clientes potenciais visualizados.
linkedin_likes
Número de posts de clientes potenciais curtidos no LinkedIn.
linkedin_follows
Número de perfis de clientes potenciais seguidos.
in_mail_sent
Número total de mensagens do InMail enviadas.
interested
Número de destinatários que, nas respostas, demonstraram interesse.
interested_rate
Porcentagem de destinatários que, nas respostas, demonstraram interesse.
maybe
Número de destinatários que, nas respostas, não expressaram interesse direto nem desinteresse.
maybe_rate
Porcentagem de destinatários que, nas respostas, não expressaram interesse direto nem desinteresse.
not_interested
Número de destinatários que, nas respostas, não demonstraram interesse.
not_interested_rate
Porcentagem de destinatários que, nas respostas, não demonstraram interesse.

GETVer andamento da campanha

Gratuito

Este método retorna o andamento e o status da campanha.

Solicitação
GEThttps://api.snov.io/v2/campaigns/[campaign_id]/progress
Parâmetros de entrada
campaign_id
*necessário
O ID da campanha. Você pode encontrá-lo no URL ao visualizar as informações da campanha (exemplo).
Exemplos de código

<?php

function getCampaignProgress()

{

   $token = getAccessToken();

   $campaignId = 1;

   $params = [

       'access_token' => $token,

   ];

   $params = http_build_query($params);

   $options = [

       CURLOPT_URL => "https://api.snov.io/v2/campaigns/$campaignId/progress?" . $params,

       CURLOPT_RETURNTRANSFER => true,

       CURLOPT_FOLLOWLOCATION => true

   ];

   $ch = curl_init();

   curl_setopt_array($ch, $options);

   $res = json_decode(curl_exec($ch), true);

   curl_close($ch);

   return $res;

}

?>

def get_campaign_progress():

   token = get_access_token()

   campaign_id = 1

   params = {

       'access_token': token,

   }

   res = requests.get(f"https://api.snov.io/v2/campaigns/{campaign_id}/progress", params=params)

   return json.loads(res.text)

Exemplo de resposta
{
    "status":"Active",
    "unfinished":1,
    "progress":"90%"
}
Parâmetros de saída
progress
Porcentagem de destinatários que:
  • Atingiram o final da sequência
  • Devolveram, responderam, responderam automaticamente, se descadastraram, foram excluídos ou foram movidos da campanha, e portanto a campanha foi interrompida para eles.
unfinished
Número de destinatários na campanha que não atingiram o final da sequência ou para quem a sequência não foi interrompida.
status
Status da campanha. Saiba mais

POSTAlterar status do destinatário

Gratuito

Altere o status de um destinatário em uma campanha específica.

Solicitação
POSThttps://api.snov.io/v1/change-recipient-status
Parâmetros de entrada
email
*necessário
O endereço de email do cliente potencial.
campaign_id
*necessário
O ID da campanha. Você pode encontrá-lo no URL ao visualizar as informações da campanha (mostrar um exemplo).
status
*necessário
Pode conter Ativo, Pausado ou Descadastrado. Você não pode alterar o status dos destinatários se o status for Finalizado ou Movido.
Exemplos de código
<?php
function changeRecipientStatus()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'email'       => 'gavin.vanrooyen@octagon.com',
        'campaign_id'    => '179025',
        'status'     => 'Paused'
    ];


    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/change-recipient-status',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def change_recipient_status():
token = get_access_token()
params = {'access_token':token,
          'email':'gavin.vanrooyen@octagon.com',
          'campaign_id': '179025',
          'status':'Paused'
}

res = requests.post('https://api.snov.io/v1/change-recipient-status', data=params)

return json.loads(res.text)
Exemplo de resposta
{
  "success": true
}
Parâmetros de saída

O método retorna success: true se o status do possível cliente foi alterado com sucesso. Se ocorrer algum erro, o método retornará success: false com uma descrição do erro.

GETVer lista de clientes potenciais concluídos

Gratuito

Este método retorna clientes potenciais para os quais a campanha foi concluída.

Solicitação
GEThttps://api.snov.io/v1/prospect-finished
Parâmetros de entrada
campaignId
*necessário
Identificador exclusivo da campanha para recuperar a lista de clientes potenciais.
Exemplos de código
<?php
function finishedProspects()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'campaignId'   => 1234567
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/prospect-finished?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token,
        'campaignId':1234567
}

res = requests.get('https://api.snov.io/v1/prospect-finished', data=params)

return json.loads(res.text)
Exemplo de resposta
[
    {
        "id": "88c268d404797d1001b4d72806207625",
        "prospectId": "9c2eb5b46bb5873e408684dd577d002354e4f7026f47bf8a592d659bba3d2dd0ff186b90dc7a5",
        "userName": "zach Jones",
        "userEmail": "zach@entselect.us",
        "campaign": "Zipari - Salesforce Developer",
        "hash": "f3967971cbab6e769b5f7e3457d00159"
    }
]
Parâmetros de saída
id
Identificador único da solicitação.
prospectId
Identificador único do cliente potencial.
userName
Nome completo do cliente potencial.
userEmail
Endereço de email do cliente potencial.
campaign
Nome da campanha.

GETVer respostas da campanha

Gratuito

Este método retorna as respostas da campanha com todas as informações, incluindo nome do cliente potencial, ID, campanha etc.

Solicitação
GEThttps://api.snov.io/v1/get-emails-replies
Parâmetros de entrada
campaignId
*necessário
Identificador exclusivo da campanha cujas respostas você deseja visualizar.
offset
Você pode coletar até 10.000 respostas para cada solicitação. Se sua campanha tiver mais respostas, use o deslocamento para indicar quantas respostas anteriores você deseja ignorar. Por exemplo, se sua campanha tiver 20.000 respostas, e você quiser solicitar as respostas de 10.001 a 20.000, configure um deslocamento de 10.000. Se o deslocamento não for especificado, você obterá as últimas 10.000 respostas recebidas.
Exemplos de código
<?php
function campaignReplies()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'campaignId'   => 1234567
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-emails-replies?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token,
        'campaignId':1234567
}

res = requests.get('https://api.snov.io/v1/get-emails-replies', data=params)

return json.loads(res.text)
Exemplo de resposta
[
    {
        "visitedAt": {
            "date": "2020-07-14 13:10:46.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "campaignId": 1234567,
        "campaign": "My top campaign",
        "prospectId": "7a941739b09f1187532d52a684df545f3a223e432c7f53662264db8d33db80ee5fc19e573416a",
        "prospectFirstName": "John",
        "prospectLastName": "Doe",
        "prospectName": "John Doe",
        "sourcePage": null,
        "source": "copy",
        "locality": null,
        "industry": "Airlines/Aviation",
        "country": null,
        "prospectEmail": "Johndoe@snov.io",
        "hash": "6745f8162ecadbe325693345d1a53976",
        "emailSubject": "\"Special content for you\"",
        "emailBody": "\"<\p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.<\/p>\"",
        "skills": "",
        "links": null,
        "customFields": null,
        "id": "f676edc5de58f341dc7bf4e75c0c8580",
        "customField_fdfd": "",
        "customField_рпа": ""
    }
]
Parâmetros de saída
campaignId
Identificador exclusivo da campanha.
campaign
Nome da campanha.
prospectName
Nome completo do cliente potencial.
emailSubject
Assunto do email que recebeu resposta.
emailBody
Conteúdo do email que recebeu resposta.

GETVer informações sobre aberturas na campanha

Gratuito

Este método mostra as informações sobre os emails abertos na campanha.

Solicitação
GEThttps://api.snov.io/v1/get-emails-opened
Parâmetros de entrada
campaignId
*necessário
Identificador exclusivo da campanha cujas informações de abertura de emails você deseja visualizar.
offset
Você pode coletar até 10.000 aberturas para cada solicitação. Se sua campanha tiver mais aberturas de e-mails, use o deslocamento para indicar quantas aberturas anteriores você deseja ignorar. Por exemplo, se sua campanha tiver 20.000 aberturas, e você quiser solicitar as aberturas de 10.001 a 20.000, configure um deslocamento de 10.000. Se o deslocamento não for especificado, você obterá as últimas 10.000 aberturas de e-mails.
Exemplos de código
<?php
function emailsOpen()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'campaignId'   => 1234567
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-emails-opened?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token,
        'campaignId':1234567
}

res = requests.get('https://api.snov.io/v1/get-emails-opened', data=params)

return json.loads(res.text)
Exemplo de resposta
[
    {
        "visitedAt": {
            "date": "2020-01-08 21:48:14.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "campaignId": 1234567
        "campaign": "My top campaign",
        "prospectId": "a9e58c3eecff94e617815a90ca412c4c305045102be1312b41fd0073c9c9f3eee30e090bbc3e3",
        "prospectFirstName": "John",
        "prospectLastName": "Doe",
        "prospectName": "John Doe",
        "sourcePage": null,
        "source": "copy",
        "locality": null,
        "industry": null,
        "country": null,
        "prospectEmail": "Johndoe@snov.io",
        "hash": "20b1aeb0e2949fdf7e58363f84b7aff1",
        "emailSubject": "\"Special content for you\"",
        "emailBody": "\"<\p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.<\/p>\"",
	"skills": "",
        "links": null,
        "customFields": null,
        "id": "c2a67a47d59745f548ea7b0213c3a81d",
        "customField_Phone": ""
    }
]
Parâmetros de saída
campaignId
Identificador exclusivo da campanha.
campaign
Nome da campanha.
prospectName
Nome completo do cliente potencial que abriu um email.
emailSubject
Assunto do email que foi aberto.
visitedAt
Horário exato em que o cliente potencial abriu o email.

GETVer cliques no link

Gratuito

Este método retorna informações sobre todos os destinatários que clicaram em algum link contido nos emails da campanha.

Solicitação
GEThttps://api.snov.io/v1/get-emails-clicked
Parâmetros de entrada
campaignId
*necessário
Identificador exclusivo da campanha cujos cliques em link você deseja visualizar.
offset
Você pode coletar até 10.000 cliques para cada solicitação. Se sua campanha tiver mais cliques, use o deslocamento para indicar quantos cliques anteriores você deseja ignorar. Por exemplo, se sua campanha tiver 20.000 cliques, e você quiser solicitar os cliques de 10.001 a 20.000, configure um deslocamento de 10.000. Se o deslocamento não for especificado, você obterá os últimos 10.000 e-mails que geraram clique no link dentro da campanha.
Exemplos de código
<?php
function emailsClicked()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'campaignId'   => 1234567
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-emails-clicked?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token,
        'campaignId':1234567
}

res = requests.get('https://api.snov.io/v1/get-emails-clicked', data=params)

return json.loads(res.text)
Exemplo de resposta
[
    {
        "visitedAt": {
            "date": "2020-01-08 21:48:14.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "campaignId": 1234567
        "campaign": "My top campaign",
        "prospectId": "a9e58c3eecff94e617815a90ca412c4c305045102be1312b41fd0073c9c9f3eee30e090bbc3e3",
        "prospectFirstName": "John",
        "prospectLastName": "Doe",
        "prospectName": "John Doe",
        "sourcePage": null,
        "source": "copy",
        "locality": null,
        "industry": null,
        "country": null,
        "prospectEmail": "Johndoe@snov.io",
        "hash": "20b1aeb0e2949fdf7e58363f84b7aff1",
        "emailSubject": "\"Special content for you\"",
        "emailBody": "\"<\p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.<\/p>\"",
	"skills": "",
        "links": null,
        "customFields": null,
        "id": "c2a67a47d59745f548ea7b0213c3a81d",
        "customField_Phone": ""
    }
]
Parâmetros de saída
campaignId
Identificador exclusivo da campanha.
campaign
Nome da campanha.
prospectName
Nome completo do cliente potencial que clicou em um link a partir de um email na campanha.
prospectEmail
Endereço de email do cliente potencial.
emailSubject
Assunto do email que continha um link que gerou clique.
emailBody
Conteúdo do email.
visitedAt
Horário exato em que o cliente potencial clicou em um link no email.

GETVer emails enviados

Gratuito

Este método mostra as informações sobre os emails enviados na campanha.

Solicitação
GEThttps://api.snov.io/v1/emails-sent
Parâmetros de entrada
campaignId
*necessário
Identificador exclusivo da campanha cujos emails enviados você deseja visualizar.
offset
Você pode coletar até 10.000 e-mails enviados para cada solicitação. Se sua campanha enviou mais e-mails, use o deslocamento para indicar quantos e-mails anteriores você deseja ignorar. Por exemplo, se sua campanha tiver 20.000 e-mails enviados, e você quiser solicitar os e-mails de 10.001 a 20.000, configure um deslocamento de 10.000. Se o deslocamento não for especificado, você obterá os últimos 10.000 e-mails que foram enviados na campanha.
Exemplos de código
<?php
function emailsSended()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'campaignId'   => 1234567
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/emails-sent?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token,
        'campaignId':1234567
}

res = requests.get('https://api.snov.io/v1/emails-sent', data=params)

return json.loads(res.text)
Exemplo de resposta
[
    {
        "sentDate": {
            "date": "2020-07-06 06:58:10.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "userName": "John Doe",
        "userEmail": "johndoe@snov.io",
        "campaign": "Test",
        "hash": "be8fd412b793c15ccab9f1a6573d6595",
        "id": "010f091d81860753a19867ba1dd805d1"
    },
    {
        "sentDate": {
            "date": "2020-07-06 06:56:44.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "userName": "Mister Smith",
        "userEmail": "mistersmith@snov.io",
        "campaign": "Test",
        "hash": "55bb20def471e630c539935cb0efcbf8",
        "id": "00e3df8427477a21d64bbe959ff95471"
    }
]
Parâmetros de saída
sentDate
Horário exato em que o email foi enviado.
userName
Nome completo do cliente potencial ao qual foi enviado o email.
userEmail
Endereço de email do cliente potencial.
campaign
Nome da campanha.

GETVer todas as campanhas

Gratuito

Este método mostra a lista de todas as campanhas do usuário.

Solicitação
GEThttps://api.snov.io/v1/get-user-campaigns
Parâmetros de entrada
Não há parâmetros de entrada para este método
Exemplos de código
<?php
function userCampaigns()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-user-campaigns?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()

headers = {'Authorization': token}

url = 'https://api.snov.io/v1/get-user-campaigns'

response = requests.request('GET', url, headers=headers)

return json.loads(res.text)
Exemplo de resposta
[
    {
        "id": 237945,
        "campaign": "New Campaign",
        "list_id": 8512947,
        "status": "Paused",
        "created_at": 1639469976,
        "updated_at": 1639470026,
        "started_at": 1639470021,
        "hash": "e272be8f9a6894f5b5894fe2ef77095e"
    },
    {
        "id": 237956,
        "campaign": "Test campaign",
        "list_id": 7654321,
        "status": "Draft",
        "created_at": 1638808262,
        "updated_at": 1638808262,
        "started_at": null,
        "hash": "f97fce248b77e9a1ae770b21c7bd783d"
    }
]
Parâmetros de saída
id
Identificador exclusivo da campanha do usuário.
campaign
Nome da campanha.
list_id
Identificador único das listas de clientes potenciais usados na campanha.
status
Status da campanha.
created_at
Criação de campanha dia e horário no formato Unix Timestamp.
updated_at
Dia e horário da atualização da última campanha no formato Unix Timestamp.
started_at
Lançamento da campanha dia e horário no formato Unix Timestamp.

POSTAdicionar à Lista de e-mails a não enviar

Gratuito

Usando este método, você pode adicionar um e-mail ou domínio à sua Lista de e-mails a não enviar. Após adicionar esse e-mail/domínio à lista, você não poderá enviar e-mails para ele.

Solicitação
POSThttps://api.snov.io/v1/do-not-email-list
Parâmetros de entrada
items
O e-mail ou domínio que você deseja adicionar à sua Lista de e-mails a não enviar.
listId
*necessário
O identificador da Lista de e-mails a não enviar ao qual pertencem os e-mails e domínios.
Exemplos de código
<?php
function addToBlackList()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token
    ];

    $data = http_build_query([
      'items' => [
          'gavin.vanrooyen@octagon.com',
          'octagon.com'
      ]
  ]);

    $options = [
        CURLOPT_URL => 'https://api.snov.io/v1/do-not-email-list?'. $data,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $params,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);
}
?>
def do_not_email_list():
    token = get_access_token()
    params = {
        'access_token':token,
        'items[]':['gavin.vanrooyen@octagon.com','octagon.com']
    }

    res = requests.post('https://api.snov.io/v1/do-not-email-list', data=params)

    return json.loads(res.text)
Exemplo de resposta
[
    {
        "success": true,
        "data": {
            "duplicates": []
        }
    }
]
Parâmetros de saída
duplicates
Este parâmetro mostra quais e-mails/domínios foram adicionados anteriormente à Lista de e-mails a não enviar.

POSTAdicionar cliente potencial à lista

Gratuito

Adicione um cliente potencial a uma lista específica. Esse método será útil para quem deseja automatizar a adição de clientes potenciais às listas com campanhas de automação de email ativas. Dessa forma, após um cliente potencial ser adicionado automaticamente a uma lista escolhida, uma campanha de automação de email será iniciada automaticamente.

Solicitação
POSThttps://api.snov.io/v1/add-prospect-to-list
Parâmetros de entrada
email
*necessário
O endereço de email do cliente potencial.
fullName
O nome completo do cliente potencial.
firstName
O nome do cliente potencial.
lastName
O sobrenome do cliente potencial.
phones
Matriz com os números de telefone do cliente potencial.
country
O país do cliente potencial. Os nomes dos países são definidos aqui. Use apenas países desta lista.
locality
O local do cliente potencial.
position
O cargo do cliente potencial.
companyName
O nome da empresa do cliente potencial.
companySite
O site da empresa do cliente potencial. Use o
http://example.com
formato.
updateContact
Atualiza um cliente potencial existente. Pode conter
true
, ou
false
. Se
true
e já existe um cliente potencial com este endereço de email em uma das listas, o sistema atualizará o perfil existente. Se
false
, o sistema não atualizará o perfil existente.
customFields[specialization]
Você pode adicionar valores personalizados aos campos personalizados criados anteriormente. Para isso, especifique o nome do campo personalizado em [brackets].
socialLinks[linkedIn]
Um link para o perfil de mídias sociais do cliente potencial. Especifique o nome da rede social entre [colchetes] (LinkedIn, Facebook ou X).
listId
*necessário
O identificador da lista ao qual o cliente potencial pertence.
Exemplos de código
<?php
function addProspectToList()
{
    $token = getAccessToken();

    $params = [
        'access_token'                => $token,
        'email'                       => 'john.doe@example.com',
        'fullName'                    => 'John Doe',
        'firstName'                   => 'John',
        'lastName'                    => 'Doe',
        'phones'                      => ['+18882073333', '+18882074444'],
        'country'                     => 'United States',
        'locality'                    => 'Woodbridge, New Jersey',
        'socialLinks[linkedIn]'       => 'https://www.linkedin.com/in/johndoe/&social',
        'social[twiiter]'             => 'https://twitter.com/johndoe&social',
        'customFields[specialization]'=> 'Software Engineering',
        'position'                    => 'Vice President of Sales',
        'companyName'                 => 'GoldenRule',
        'companySite'                 => 'https://goldenrule.com',
        'updateContact'               => true,
        'listId'                      => '12345',
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/add-prospect-to-list',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);
    
    return $res;

}
?>
def add_prospect_to_list():
token = get_access_token()
params = {'access_token':token,
          'email':'john.doe@example.com',
          'fullName': 'John Doe',
          'firstName':'John',
          'lastName':'Doe',
          'phones':['+18882073333', '+18882074444'],
          'country':'United States',
          'locality':'Woodbridge, New Jersey',
          'socialLinks[linkedIn]':'https://www.linkedin.com/in/johndoe/&social',
          'social[twiiter]':'https://twitter.com/johndoe&social',
          'customFields[specialization]':'Software Engineering',
          'position':'Vice President of Sales',
          'companyName':'GoldenRule',
          'companySite':'https://goldenrule.com',
          'updateContact':1,
          'listId':'12345'
}

res = requests.post('https://api.snov.io/v1/add-prospect-to-list', data=params)

return json.loads(res.text)
Exemplo de resposta
{
    "success": true,
    "id": "0Y2QzowWL1rHpIptwaRp0Q==",
    "added": true,
    "updated": false
}
Parâmetros de saída
success
É
true
se o cliente potencial foi adicionado à lista com sucesso.
id
Identificador do cliente potencial adicionado.
added
É
true
se o cliente potencial foi adicionado à lista.
updated
É
true
se os dados existentes do cliente potencial foram atualizados.
errors
Houve um erro ao adicionar o cliente potencial à lista.

POSTLocalizar cliente potencial por ID

Gratuito

Localize clientes potenciais de suas listas por ID. Ao conhecer o ID de um cliente potencial específico, você pode obter informações completas sobre esse cliente potencial, incluindo as listas e campanhas às quais ele foi adicionado.

Solicitação
POSThttps://api.snov.io/v1/get-prospect-by-id
Parâmetros de entrada
id
*necessário
O ID do cliente potencial. Você pode vê-lo na resposta ao adicionar um cliente potencial por meio de Adicionar cliente potencial à lista Método de API ou no URL ao visualizar a página do cliente potencial (ver um exemplo).
Exemplos de código
<?php
function getProspectById()
{
    $token = getAccessToken();

    $params = [
        'access_token'    => $token,
        'id'           => 'xusD3-T_K5IktGoaa8Jc8A=='
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-prospect-by-id',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);
    
    return $res;

}
?>
def getProspectById():
token = get_access_token()
params = {'access_token':token,
        'id':'xusD3-T_K5IktGoaa8Jc8A=='
}

res = requests.post('https://api.snov.io/v1/get-prospect-by-id', data=params)

return json.loads(res.text)
Exemplo de resposta
{
  "success": true,
  "data": {
    "id": "xusD3-T_K5IktGoaa8Jc8A==",
    "name": "Gavin Vanrooyen",
    "firstName": "Gavin",
    "lastName": "Vanrooyen",
    "industry": "Entertainment",
    "country": "United States",
    "locality": "Greater Atlanta Area",
    "social": [
      {
        "link": "https:\/\/www.linkedin.com\/in\/gavin-vanrooyen-8090738\/",
        "type": "linkedIn"
      }
    ],
    "lastUpdateDate": {
      "date": "2019-09-11 12:37:58.000000",
      "timezone_type": 3,
      "timezone": "UTC"
    },
    "currentJob": [
      {
        "companyName": "Octagon",
        "position": "Senior Brand Director",
        "socialLink": "https:\/\/www.linkedin.com\/company\/659312",
        "site": "http:\/\/octagon.com",
        "locality": "United States",
        "state": null,
        "city": null,
        "street": null,
        "street2": null,
        "postal": null,
        "founded": null,
        "startDate": "2018-07-31",
        "endDate": null,
        "size": "1-10",
        "industry": "Entertainment",
        "companyType": "Public Company",
        "country": "United States"
      }
    ],
    "previousJob": [
      {
        "companyName": "UPS",
        "position": "Manager, Sponsorships and Events",
        "socialLink": "https:\/\/www.linkedin.com\/company\/152322",
        "site": "http:\/\/www.ups.com\/",
        "locality": "United States",
        "state": "GA",
        "city": "Atlanta",
        "street": "55 Glenlake Parkway, NE",
        "street2": null,
        "postal": "30328",
        "founded": "1907",
        "startDate": null,
        "endDate": null,
        "size": "10001+",
        "industry": "Logistics and Supply Chain",
        "companyType": "Public Company",
        "country": "United States"
      }
    ],
    "lists": [
      {
        "id": 1250344,
        "name": "People List"
      }
    ],
    "campaigns": []
  }
}
Parâmetros de saída
success
É
true
se o cliente potencial foi encontrado
id
Identificador de perfil único
name
Nome completo do cliente potencial
firstName
Nome do cliente potencial
lastName
Sobrenome do cliente potencial
industry
Setor confirme indicado no perfil do cliente potencial
country
País do cliente potencial
locality
Local do cliente potencial
social
Links para os perfis sociais do cliente potencial
currentJobs
A série contém informações sobre o cargo atual do cliente potencial
previousJobs
A série contém informações sobre os cargos anteriores do cliente potencial
lastUpdateDate
Data da última atualização do perfil
lists
Lista à qual o cliente potencial foi adicionado
campaigns
Lista de campanhas às quais este cliente potencial foi adicionado como destinatário. Contém estatísticas curtas como status, número de mensagens enviadas, aberturas e respostas.

POSTLocalizar cliente potencial por email

Gratuito

Encontre clientes potenciais de suas listas por endereço de email. Ao pesquisar por email, você recebe uma lista de todos os clientes potenciais vinculados a este endereço de email. Cada elemento da lista contém informações completas sobre os clientes potenciais, incluindo as listas e campanhas às quais eles foram adicionados.

Solicitação
POSThttps://api.snov.io/v1/get-prospects-by-email
Parâmetros de entrada
email
*necessário
O endereço de email do cliente potencial
Exemplos de código
<?php
function getProspectsByEmail()
{
    $token = getAccessToken();

    $params = [
        'access_token'    => $token,
        'email'           => 'gavin.vanrooyen@octagon.com'
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-prospects-by-email',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);
    
    return $res;

}
?>
def getProspectsByEmail():
token = get_access_token()
params = {'access_token':token,
        'email':'gavin.vanrooyen@octagon.com'
}

res = requests.post('https://api.snov.io/v1/get-prospects-by-email', data=params)

return json.loads(res.text)
Exemplo de resposta
{
  "success": true,
  "data": [
    {
      "id": "xusD3-T_K5IktGoaa8Jc8A==",
      "name": "Gavin Vanrooyen",
      "firstName": "Gavin",
      "lastName": "Vanrooyen",
      "industry": "Entertainment",
      "country": "United States",
      "locality": "Greater Atlanta Area",
      "social": [
        {
          "link": "https:\/\/www.linkedin.com\/in\/gavin-vanrooyen-809073755\/",
          "type": "linkedIn"
        }
      ],
      "lastUpdateDate": {
        "date": "2019-09-11 12:37:58.000000",
        "timezone_type": 3,
        "timezone": "UTC"
      },
      "currentJob": [
        {
          "companyName": "Octagon",
          "position": "Senior Brand Director",
          "socialLink": "https:\/\/www.linkedin.com\/company\/659333",
          "site": "http:\/\/octagon.com",
          "locality": "United States",
          "state": null,
          "city": null,
          "street": null,
          "street2": null,
          "postal": null,
          "founded": null,
          "startDate": "2018-07-31",
          "endDate": null,
          "size": "1-10",
          "industry": "Entertainment",
          "companyType": "Public Company",
          "country": "United States"
        }
      ],
      "previousJob": [
        {
          "companyName": "UPS",
          "position": "Manager, Sponsorships and Events",
          "socialLink": "https:\/\/www.linkedin.com\/company\/1523574",
          "site": "http:\/\/www.ups.com\/",
          "locality": "United States",
          "state": "GA",
          "city": "Atlanta",
          "street": "55 Glenlake Parkway, NE",
          "street2": null,
          "postal": "30328",
          "founded": "1907",
          "startDate": null,
          "endDate": null,
          "size": "10001+",
          "industry": "Logistics and Supply Chain",
          "companyType": "Public Company",
          "country": "United States"
        }
      ],
      "lists": [
        {
          "id": 1250344,
          "name": "People List"
        }
      ],
      "campaigns": []
    }
  ]
}
Parâmetros de saída
success
É
true
se o cliente potencial foi encontrado
id
Identificador de perfil único
name
Nome completo do cliente potencial
firstName
Nome do cliente potencial
lastName
Sobrenome do cliente potencial
industry
Setor confirme indicado no perfil do cliente potencial
country
País do cliente potencial
locality
Local do cliente potencial
social
Links para os perfis sociais do cliente potencial
currentJobs
A série contém informações sobre o cargo atual do cliente potencial
previousJobs
A série contém informações sobre os cargos anteriores do cliente potencial
lastUpdateDate
Data da última atualização do perfil
lists
Lista à qual o cliente potencial foi adicionado
campaigns
Lista de campanhas às quais este cliente potencial foi adicionado como destinatário. Contém estatísticas curtas como status, número de mensagens enviadas, aberturas e respostas.

GETEncontrar os campos personalizados do cliente potencial

Gratuito

Este método retorna uma lista de todos os campos personalizados criados pelo usuário, incluindo nome do campo, se ele é opcional ou necessário e tipo de dado do campo.

Solicitação
GEThttps://api.snov.io/v1/prospect-custom-fields
Parâmetros de entrada
Não há parâmetros de entrada para este método
Exemplos de código
<?php
function customFields()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/prospect-custom-fields?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def custom_fields():
token = get_access_token()
params = {'access_token':token
}

res = requests.get('https://api.snov.io/v1/prospect-custom-fields', data=params)

return json.loads(res.text)
Exemplo de resposta
  [
    {
        "key": "customFields['company']",
        "label": "company",
        "required": false,
        "type": "string"
    },
    {
        "key": "customFields['Project name']",
        "label": "Project name",
        "required": false,
        "type": "string"
    },
    {
        "key": "customFields['SEO']",
        "label": "SEO",
        "required": false,
        "type": "string"
    }
  ]
Parâmetros de saída
key
A chave do campo na matriz
customFields
.
label
O nome do campo.
required
É
true
se o campo personalizado é necessário.
type
O tipo de dado do campo (cadeia de caracteres, número ou data).

GETVer listas do usuário

Gratuito

Este método retorna todas as listas criadas pelo usuário. Você pode usá-lo para examinar listas que podem ser usadas para uma campanha de automação de email.

Solicitação
GEThttps://api.snov.io/v1/get-user-lists
Parâmetros de entrada
Não há parâmetros de entrada para este método
Exemplos de código
<?php
function getUserLists()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-user-lists?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token
}

res = requests.get('https://api.snov.io/v1/get-user-lists', data=params)

return json.loads(res.text)
Exemplo de resposta
[
    {
        "id": 1818597,
        "name": "FirstSend",
        "contacts": 1,
        "isDeleted": false,
        "creationDate": {
            "date": "2020-04-07 08:25:44.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "deletionDate": null
    },
    {
        "id": 1505383,
        "name": "All prospects",
        "contacts": 10,
        "isDeleted": true,
        "creationDate": {
            "date": "2019-12-17 15:07:30.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "deletionDate": {
            "date": "2020-02-17 14:05:44.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        }
    },
    {
        "id": 1479070,
        "name": "EMAIL",
        "contacts": 13,
        "isDeleted": true,
        "creationDate": {
            "date": "2019-12-06 10:51:01.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "deletionDate": {
            "date": "2020-02-17 14:05:48.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        }
    }
]

Parâmetros de saída
id
Identificador único da lista do usuário.
name
Nome da lista
contacts
O número de clientes potenciais na lista.
isDeleted
Status da lista. É
true
se a lista foi excluída.
creationDate
Data e hora da criação da lista (incluindo informações de data, hora e fuso horário).
deleteDate
Se a lista foi excluída, contém a data e hora da exclusão da lista (incluindo informações de data, hora e fuso horário).

POSTVer clientes potenciais na lista

Gratuito

Este método retorna todos os dados sobre os clientes potenciais em uma lista específica, incluindo os dados do cliente potencial, como endereço de email e status.

Solicitação
POSThttps://api.snov.io/v1/prospect-list
Parâmetros de entrada
listId
*necessário
Identificador único da lista.
page
Você pode escolher em que página da lista iniciar sua pesquisa. Este campo é opcional.
perPage
Defina o número máximo de prospects a serem incluídos na resposta. O valor máximo é 5.000.
Exemplos de código
<?php
function prospectsInList()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'listId'       => '1234567',
        'page'         => '1',
        'perPage'      => '2'
    ];

    $options = [
        CURLOPT_URL            => ' https://api.snov.io/v1/prospect-list',
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def prospect_in_list():
token = get_access_token()
params = {'access_token':token,
        'listId':'1234567',
        'page':'1',
        'perPage':'2'
}

res = requests.post('https://api.snov.io/v1/prospect-list', params=params)

return json.loads(res.text)
Exemplo de resposta

Observe que os resultados de clientes potenciais são exibidos em ordem reversa, do último ao primeiro.

{
    "success": true,
    "list": {
        "name": "Lead LIST",
        "contacts": 3,
        "creationDate": {
            "date": "2020-05-19 17:34:39.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "emailsCount": []
    },
    "prospects": [
        {
            "id": "226db935fc93422496fda5d5209e8cbf77cc77ec685891706028009b86608f7ce5877a3faf",
            "name": "Andrew Garfiled",
            "firstName": "Andrew",
            "lastName": "Garfiled",
            "emails": [
                {
                    "email": "andrewexp@exp.com",
                    "probability": 99,
                    "isVerified": null,
                    "jobStatus": "any",
                    "domainType": "linkedin_email",
                    "isValidFormat": null,
                    "isDisposable": null,
                    "isWebmail": null,
                    "isGibberish": null,
                    "smtpStatus": null
                }
            ]
        },
        {
            "id": "f20d30219b039d1408d837a748a1e2ab843c97e65080f6cf8fa7d948477d9093d87413f05f",
            "name": "John Doe",
            "firstName": "John",
            "lastName": "Doe",
            "emails": [
                {
                    "email": "johndoe@gmail.com",
                    "probability": 99,
                    "isVerified": null,
                    "jobStatus": "any",
                    "domainType": "linkedin_email",
                    "isValidFormat": true,
                    "isDisposable": false,
                    "isWebmail": true,
                    "isGibberish": false,
                    "smtpStatus": 3
                }
            ]
        }
    ]
}

Parâmetros de saída
list
Uma matriz com informações sobre a lista e os clientes potenciais contidos nela.
name
O nome da lista.
contacts
O número de clientes potenciais na lista.
creation_date
Data da criação da lista (incluindo informações de data, hora e fuso horário).
emailsCount
Número de emails na lista.
prospects
Relação de clientes potenciais na lista.
id
Identificador único do cliente potencial.
name
Nome completo do cliente potencial.
emails
Lista de emails pertencentes ao cliente potencial.

POSTCriar nova lista de clientes potenciais

Gratuito

Use este método para criar novas listas de clientes potenciais na sua conta.

Solicitação
POSThttps://api.snov.io/v1/lists
Parâmetros de entrada
name
O nome da nova lista de clientes potenciais.
Exemplos de código
<?php
function createNewList()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'name' => 'New list'
    ];

    $options = [
        CURLOPT_URL => 'https://api.snov.io/v1/lists',
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);
}
?>
def add_prospect_list():
    token = get_access_token()
    params = {
        'access_token':token,
        'name':'New list'
    }

    res = requests.post('https://api.snov.io/v1/lists', data=params)

    return json.loads(res.text)
Exemplo de resposta
[
    {
        "success": true,
        "data": {
            "id": 1234567
        }
    }
]
Parâmetros de saída
id
O ID da lista de clientes potenciais criada.

GETVerificar saldo do usuário

Gratuito

Use este método para verificar seu saldo de créditos.

Solicitação
GEThttps://api.snov.io/v1/get-balance
Parâmetros de entrada
Não há parâmetros de entrada para este método
Exemplos de código
<?php
function getBalance()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-balance?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def get_balance():
token = get_access_token()
headers = {'authorization':token
}

res = requests.get('https://api.snov.io/v1/get-balance', headers=headers)

return json.loads(res.text)
Exemplo de resposta
{
    "success": true,
    "data": {
        "balance": "25000.00",
        "teamwork": false,
        "unique_recipients_used": 0,
        "limit_resets_in": 29,
        "expires_in": 359
    }
}

Parâmetros de saída
balance
Saldo atual do usuário em créditos.
teamwork
Verdadeiro se você é membro ou líder de equipe atualmente. Falso se você não faz parte de nenhuma equipe.
recipients_used
Número de destinatários exclusivos usados neste mês.
limit_resets_in
Dias até a redefinição de limite.
expires_in
Dias até o fim da assinatura.

Webhooks

Descrição

Webhooks permitem que você receba notificações de eventos que aconteceram na sua conta da Snov.io.

Você pode usar webhooks para chamar o endpoint (URL) do seu servidor sempre que ocorre um evento assinado na Snov.io e enviar dados em tempo real para seu aplicativo.

Sempre que ocorre um evento, a Snov.io envia uma solicitação HTTP com corpo JSON para o endpoint (URL) especificado.

Você pode assinar e gerenciar webhooks por meio de um conjunto de chamadas de API.

Listamos a seguir os objetos e ações de webhook suportados:

Objeto de webhookAçãoQuando é ativado
campaign_email
sentQuando qualquer e-mail é enviado ao destinatário em qualquer campanha de automação
first_sentQuando o primeiro e-mail é enviado ao destinatário em qualquer campanha de automação
openedQuando um destinatário abre qualquer e-mail de qualquer campanha de automação
campaign_reply
receivedQuando o destinatário responde a qualquer e-mail em qualquer uma das campanhas
first_receivedQuando o destinatário responde ao e-mail pela primeira vez em qualquer uma das campanhas
company
found_domains_by_namesQuando você solicita o domínio de uma empresa com base no nome dela.
prospect
found_by_li_urlQuando você solicita as informações do perfil de um cliente potencial com base no respectivo URL do LinkedIn.
email_verification
verifiedQuando você solicita a verificação de e-mail.

Limites: usuários de planos premium podem criar até 50 webhooks.

Política de novas tentativas: o webhook será bem-sucedido se recebermos um status HTTP de 200 a 299 como resposta em até 3 segundos.

Se recebermos qualquer outro status HTTP ou for ultrapassado o tempo limite, faremos sete novas tentativas com intervalos cada vez maiores até 38 horas após o evento que iniciou um webhook:

Se todas as sete tentativas forem malsucedidas, o webhook será desativado.

  • 1ª: imediatamente após o evento
  • 2ª: 20 minutos após a última tentativa (20 minutos após o evento)
  • 3ª: 40 minutos após a última tentativa (1 hora após o evento)
  • 4ª: 60 minutos após a última tentativa (2 horas após o evento)
  • 5ª: 4 horas após a última tentativa (6 horas após o evento)
  • 6ª: 8 horas após a última tentativa (14 horas após o evento)
  • 7ª: 24 horas após a última tentativa (38 horas após o evento)

GETListar todos os webhooks

Este método de API permite obter uma lista de webhooks da sua conta.
Solicitação
GEThttps://api.snov.io/v2/webhooks
Cabeçalho de solicitação

Tipo de conteúdo: application/json

Parâmetros de entrada
Este método não tem parâmetros de entrada.
Exemplo de resposta
{
    "data": [
        {
            "data": {
                "id": 8,
                "end_point": "https://hooks.yourdomain.com/hooks/catch/1237321/awwwcz/",
                "event_object": "campaign_email",
                "event_action": "sent",
                "status": "active",
                "created_at": 1655847444
            }
        },
        {
            "data": {
                "id": 14,
                "end_point": "https://hooks.yourdomain.com/hooks/catch/1237321/abqqqpcz/",
                "event_object": "campaign_email",
                "event_action": "sent",
                "status": "deactivated",
                "created_at": 1655890563
            }
        },
        {
            "data": {
                "id": 17,
                "end_point": "https://hooks.yourdomain.com/hooks/catch/1237321/abwfpcz/",
                "event_object": "campaign_email",
                "event_action": "sent",
                "status": "active",
                "created_at": 1656057947
            }
        }
    ],
    "meta": {
        "webhooks_count": 3,
        "user_id": 1313777
    }
}
Parâmetros de saída
A resposta retorna uma coleção de modelos de webhook. Listamos as propriedades do modelo a seguir:
ParâmetroTipo de dadosTipo de dados
data
arrayColeção de modelos de webhook
id
intID de webhook
end_point
stringA URL real que você forneceu ao adicionar o webhook e para onde será feito o envio
event_object
stringO objeto sobre o qual a ação é executada
event_action
stringA ação realizada no objeto
created_at
intData de criação do webhook no formato de timestamp Unix
status
stringStatus do webhook: active, deactivated
meta
objectDados relacionados
webhooks_count
intNúmero total de webhooks na sua conta (máx. 50)
user_id
intSeu ID de usuário

POSTAdicionar webhook

Este método de API permite criar uma assinatura de webhook e receber notificações de evento no URL de endpoint especificado.
Solicitação
POSThttps://api.snov.io/v2/webhooks
Cabeçalho de solicitação

Tipo de conteúdo: application/json

Parâmetros de entrada
event_object
o objeto sobre o qual a ação é executada (lista de objetos suportados)
event_action
a ação realizada no objeto (lista de ações suportadas)
endpoint_url
o endereço da URL para onde o webhook é enviado
Exemplo de solicitação
{
  "event_object": "campaign_email",
  "event_action": "sent",
  "endpoint_url": "https://hooks.yourdomain.com/hooks/catch/1237321/abwfpcz/"
}
Exemplo de resposta
{
    "data": {
        "id": 17,
        "end_point": "https://hooks.yourdomain.com/hooks/catch/1237321/abwfpcz/",
        "event_object": "campaign_email",
        "event_action": "sent",
        "created_at": 1656057947,
        "status": "active"
    },
    "meta": {
        "user_id": 1313777
    }
}
Parâmetros de saída
A resposta retorna um modelo do webhook adicionado. Listamos as propriedades do modelo a seguir:
ParâmetroTipo de dadosTipo de dados
data
objectDados do webhook
id
intID de webhook
end_point
stringA URL real que você forneceu ao adicionar o webhook e para onde será feito o envio
event_object
stringO objeto sobre o qual a ação é executada
event_action
stringA ação realizada no objeto
created_at
intData de criação do webhook no formato de timestamp Unix
status
stringStatus do webhook: active, deactivated
meta
objectDados relacionados
user_id
intSeu ID de usuário

PUTAlterar status de webhook

Altera o status de uma assinatura de webhook escolhida.

Inclua o valor “id” exclusivo do webhook escolhido no final do endereço URL da solicitação.

Use o método "Listar todos os webhooks" para obter os valores de id de seus webhooks.

Solicitação
PUThttps://api.snov.io/v2/webhooks/webhook_id
Cabeçalho de solicitação

Tipo de conteúdo: application/json

Parâmetros de entrada
status
active ou deactivated
Exemplo de solicitação
{
    https://api.snov.io/v2/webhooks/14
    "status": "deactivated"
}
Exemplo de resposta
{
    "data": {
        "id": 14,
        "end_point": "https://hooks.yourdomain.com/hooks/catch/1237321/abqqqpcz/",
        "event_object": "campaign_email",
        "event_action": "sent",
        "created_at": 1655890563,
        "status": "deactivated"
    },
    "meta": {
        "user_id": 1313777
    }
}
Parâmetros de saída
A resposta retorna um modelo do webhook adicionado. Listamos as propriedades do modelo a seguir:
ParâmetroTipo de dadosTipo de dados
data
objectDados do webhook
id
intID de webhook
end_point
stringA URL real que você forneceu ao adicionar o webhook e para onde será feito o envio
event_object
stringO objeto sobre o qual a ação é executada
event_action
stringA ação realizada no objeto
created_at
intData de criação do webhook no formato de timestamp Unix
status
stringStatus do webhook: active, deactivated
meta
objectDados relacionados
user_id
intSeu ID de usuário

DELETEExcluir um webhook

Exclui um webhook escolhido.

Inclua o valor “id” exclusivo do webhook escolhido no final do endereço URL da solicitação.

Use o método "Listar todos os webhooks" para obter os valores de id de seus webhooks.

Solicitação
DELETEhttps://api.snov.io/v2/webhooks/webhook_id
Cabeçalho de solicitação

Tipo de conteúdo: application/json

Exemplo de solicitação
{
    https://api.snov.io/v2/webhooks/8
}
Exemplo de resposta
{
    "data": {
        "success": true
    }
}
Parâmetros de saída
A resposta retorna uma coleção de modelos de webhook. Listamos as propriedades do modelo a seguir:
ParâmetroTipo de dadosTipo de dados
success
booleanIndica se o webhook foi removido