Smile
A PROMOÇÃO DE BLACK FRIDAY JÁ COMEÇOU!TODOS OS PLANOS ANUAIS ESTÃO COM 50% DE DESCONTO!ArrowBlack Friday 2020
Aproveite a promoção-50 %

API do Snov.io

Os recursos de nosso serviço estão disponíveis com a nossa API REST simples. Integre-se à API do Snov.io para sincronizar seu leads e gerenciar os clientes potenciais. A API do Snov.io permite obter uma lista de todos os e-mails de um domínio específico, localizar endereços de e-mail por nome e domínio, verificar e-mails, adicionar clientes potenciais a uma lista, alterar o status do destinatário e muito mais.

Atenção: a taxa de API é limitada a 60 solicitações por minuto.

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 conta https://app.snov.io/api-setting
client_secret
Sua chave secreta está disponível nas configurações da conta https://app.snov.io/api-setting
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']
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

Contagem de e-mailsGratuito

Com este método de API, você pode descobrir o número de endereços de e-mail 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 e-mails 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)
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 e-mails 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 e-mail que encontramos para este domínio. Como não podemos fornecer resultados para domínios de webmail, o resultado do webmail será sempre
0
.

Pesquisa de domínios V.21 credit per 10 emails/prospects

Insira um nome de domínio e o Snov.io retornará todos os endereços de e-mail no domínio.
Se houver alguma informação adicional sobre o proprietário do e-mail disponível no banco de dados, nós a adicionaremos também.
Cada resposta retorna até 100 e-mails. Se não retornar pelo menos um e-mail, você não será cobrado pela solicitação.
Solicitação
GEThttps://api.snov.io/v2/domain-emails-with-info
Parâmetros de entrada
domain
O nome do domínio a partir do qual você deseja localizar os endereços de e-mail. Por exemplo, "snov.io".
type
Pode conter valores diferentes -"
all
", "
personal
" ou "
generic
" . Um endereço de e-mail genérico é um endereço de e-mail baseado em uma função, por exemplo - contact@snov.io.

Um endereço de e-mail pessoal é o e-mail da pessoa que trabalha na empresa.

limit
Defina o limite para especificar o número de endereços de e-mail a serem retornados. Cada resposta retorna até 100 endereços de e-mail.
lastId
Para coletar mais e-mails do que o definido no seu parâmetro de entrada Limit, indique na próxima solicitação o ID do último endereço de e-mail coletado da solicitação anterior. Assim, serão ignorados os e-mails coletados anteriormente.
Observe que lastId é um parâmetro obrigatório. O valor padrão é
0
.
Exemplos de código
<?php
function getDomainSearch()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'domain'       => 'octagon.com',
        'type'         => 'all',
        'limit'        => 100,
        'lastId'       => 0
    ];

    $params = http_build_query($params);
    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-emails-with-info?'.$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_domain_search():
token = get_access_token()
params = {
  'access_token': token,
  'domain': 'octagon.com',
  'type': 'all',
  'limit': 100,
  'lastId': 0
}

res = requests.get('https://api.snov.io/v2/domain-emails-with-info', params=params)

return json.loads(res.text)
Resposta
{
  "success": true,
  "domain": "octagon.com",
  "webmail": false,
  "result": 84,
  "lastId": 1823487525,
  "limit": 100,
  "companyName": "Octagon",
  "emails": [
      {
      "email": "ben.gillespie@octagon.com",
      "firstName": "Ben",
      "lastName": "Gillespie",
      "position": "Senior Account Executive",
      "sourcePage": "https://www.linkedin.com/pub/ben-gillespie/7/73/809",
      "companyName": "Octagon",
      "type": "prospect",
      "status": "verified"
      }
    ]
}
Parâmetros de saída
domain
O nome de domínio para o qual a API forneceu os endereços de e-mail.
webmail
É "
true
" se o domínio que você está pesquisando for um webmail.
result
Um número de endereços de e-mail que encontramos para este domínio. Como não podemos fornecer resultados para domínios de webmail, o resultado do webmail será sempre
0
.
limit
Especifica o número máximo de endereços de e-mail a serem retornados.
companyName
O nome da empresa usado para encontrar os endereços de e-mail.
emails
A série de e-mails de domínio recuperados na pesquisa.
email
Um endereço de e-mail específico recuperado na pesquisa.
type
Pode conter "
prospect
" ou "
email
" valores. Se o tipo retornado for "
prospect
" , o Snov.io encontrou informações adicionais sobre o proprietário do e-mail.
status
Status de verificação do e-mail. O status pode ser "
verified
" ou "
notVerified
".
firstName
O nome do proprietário do e-mail.
lastName
O sobrenome do proprietário do e-mail.
position
O cargo atual do proprietário do e-mail.
sourcePage
A página de origem dos dados pessoais recuperados.
lastId
o ID do último e-mail coletado da resposta anterior.

Verificador de e-mailsGratuito

Verifique se os endereços de e-mail fornecidos são válidos e podem ser entregues. O endpoint da API retornará os resultados da verificação por e-mail. Se não tivermos verificado um determinado endereço de e-mail antes, os resultados não serão retornados a você. Nesse caso, a API retornará um identificador "not_verified" e você não receberá créditos por este e-mail. Você deve usar o Adicionar e-mails para verificação método para enviar este endereço de e-mail para verificação, após o qual você poderá obter os resultados da verificação de e-mail usando este endpoint.

Solicitação
POSThttps://api.snov.io/v1/get-emails-verification-status
Parâmetros de entrada
emails
Os endereços de e-mail que você precisa verificar.
Exemplos de código
<?php
function getEmailVerifier()
{
    $token = getAccessToken();
    $emails = ['gavin.vanrooyen@octagon.com', 'lizi.hamer@octagon.com'];

    $emailsQuery = http_build_query(
        [
            'emails' => $emails
        ]
    );
    $params = ['access_token' => $token];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-emails-verification-status?' . $emailsQuery,
        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_verifier():
token = get_access_token()
params = {'access_token':token,
}

res = requests.post('https://api.snov.io/v1/get-emails-verification-status?emails[]=gavin.vanrooyen@octagon.com&emails[]=lizi.hamer@octagon.com', data=params)

return json.loads(res.text)
Resposta
{
"success":true,
"gavin.vanrooyen@octagon.com":{
"status":{
"identifier":"not_verified",
"description":"Email is not verified, try to send it for verification"
},
"data":[
]
},
"lizi.hamer@octagon.com":{
"data":{
"email":"lizi.hamer@octagon.com",
"isValidFormat":true,
"isDisposable":false,
"isWebmail":true,
"isGibberish":false,
"smtpStatus":"valid"
},
"status":{
"identifier":"complete",
"description":"Email verification is completed"
}
}
}

Este método retornará dados para cada endereço de e-mail solicitado. A resposta contém um status de verificação de e-mail e os resultados da verificação.

Parâmetros de saída
status
O status de verificação do e-mail. Contém identificador e descrição.
identifier
Pode conter os seguintes valores: "
complete
", "
in_progress
", ou "
not_verified
". Se o identificador for "
not_verified
", "
data
" será vazio.
description
Aqui, você verá uma descrição do texto do status de verificação.
data
Contém mais resultados de verificação - "
email
", "
isValidFormat
", "
isWebmail
", "
isGibberish
".
email
O endereço de e-mail que foi verificado.
isValidFormat
É "
true
" se o formato do e-mail estiver correto, ou seja, se contiver símbolos válidos na ordem correta.
isDisposable
É "
true
" se acharmos que esse endereço de e-mail é de um serviço de e-mail descartável.
isWebmail
É "
true
" se este endereço de e-mail for de um webmail.
isGibberish
É "
true
" se este endereço de e-mail tiver sido gerado automaticamente.
smtpStatus
Pode retornar "
valid
", "
not_valid
", "
greylisted
" ou "
unknown
" (Não verificável). Você pode saber mais sobre status de e-mail aqui.
Se você receber um status SMTP de "
greylisted
", significa que estamos temporariamente impossibilitados de verificar este e-mail e continuaremos as tentativas de validá-lo.
Você pode reenviar esta solicitação ao API após um curto intervalo (geralmente de 15 minutos a uma hora) para receber os resultados corretos.
Observe que não cobramos por e-mails com status "
greylisted
" até terminarmos de validá-los e recebermos um status SMTP definitivo, "
valid
" ou "
not_valid
".

Adicionar e-mails para verificação0,5 crédito por endereço de e-mail

Se você nunca verificou um determinado endereço de e-mail antes, deve enviá-lo para verificação usando este método de API. Depois de executar esta ação, você poderá receber os resultados da verificação usando o Verificador de e-mails.

Solicitação
POSThttps://api.snov.io/v1/add-emails-to-verification
Parâmetros de entrada
emails
Uma lista de endereços de e-mail que você precisa adicionar à fila de verificação. Cada solicitação pode conter até 10 e-mails.
Exemplos de código
<?php
function addEmailsForVerification()
{
    $token = getAccessToken();
    $emails = ['gavin.vanrooyen@octagon.com', 'lizi.hamer@octagon.com'];

    $emailsQuery = http_build_query(
        [
            'emails' => $emails
        ]
    );
    $params = ['access_token' => $token];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/add-emails-to-verification?' . $emailsQuery,
        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_emails_for_verification():
token = get_access_token()
params = {'access_token': token
}

res = requests.post('https://api.snov.io/v1/add-emails-to-verification?emails[]=gavin.vanrooyen@octagon.com&emails[]=lizi.hamer@octagon.com', data=params)

return json.loads(res.text)
Resposta
{
"success":true,
"gavin.vanrooyen@octagon.com":{
"sent":true
},
"lizi.hamer@octagon.com":{
"sent":true
}
}

Se um endereço de e-mail for adicionado com sucesso à fila, o método retornará "sent":true.

Localizador de e-mailsGratuito

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

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 e-mail.
lastName
O sobrenome do proprietário do endereço de e-mail.
domain
O nome do domínio da empresa que é usado no endereço de e-mail.
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)
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 e-mails vazios.
description
Aqui, você verá uma descrição do texto do status de localização de e-mail.
data
Contém o resultado da pesquisa.
firstName
O nome do proprietário do endereço de e-mail.
lastName
O sobrenome do proprietário do endereço de e-mail.
emails
A série de endereços de e-mail com seus status. Valor "
emailStatus
" pode conter: "
valid
" ou "
unknown
".

Adicionar nomes para localizar e-mails1 crédito por solicitação

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

Solicitação
POSThttps://api.snov.io/v1/add-names-to-find-emails
Solicitação
firstName
O nome do proprietário do endereço de e-mail.
lastName
O sobrenome do proprietário do endereço de e-mail.
domain
O nome do domínio da empresa que é usado no endereço de e-mail.
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)
Resposta
{
"success":true,
"firstName":"gavin",
"lastName":"vanrooyen",
"domain":"octagon.com",
"userId":666871,
"sent":true
}

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

Obter perfil com e-mail1 crédito por solicitação

Forneça um endereço de e-mail e o Snov.io retornará todas as informações de perfil conectadas ao proprietário do endereço de e-mail fornecido a partir do banco de dados.
Se não encontrarmos informações sobre o proprietário do e-mail 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 e-mail 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)
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 e-mail.
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.

Adicionar cliente potencial à listaGratuito

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 gotejamento por e-mail ativas. Dessa forma, após um cliente potencial ser adicionado automaticamente a uma lista escolhida, uma campanha de gotejamento por e-mail 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 e-mail do cliente potencial.
fullName
O nome completo do cliente potencial.
firstName
O nome do cliente potencial.
lastName
O sobrenome 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 e-mail em uma das listas, o sistema atualizará o perfil existente. Se "
false
" , o sistema não atualizará o perfil existente.
customFields[phone number]
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 rede social do cliente potencial. Especifique o nome da rede social entre [colchetes] (LinkedIn, Facebook ou Twitter).
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',
        'country'                   => 'United States',
        'locality'                  => 'Woodbridge, New Jersey',
        'socialLinks[linkedIn]'     => 'https://www.linkedin.com/in/johndoe/&social',
        'social[twiiter]'           => 'https://twitter.com/johndoe&social',
        'customFields[phone number]'=> '+ 1 888 2073333',
        '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',
          'country':'United States',
          'locality':'Woodbridge, New Jersey',
          'socialLinks[linkedIn]':'https://www.linkedin.com/in/johndoe/&social',
          'social[twiiter]':'https://twitter.com/johndoe&social',
          'customFields[phone number]':'+ 1 888 2073333',
          '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)
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.

Localizar cliente potencial por IDGratuito

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)
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.

Localizar cliente potencial por e-mailGratuito

Encontre clientes potenciais de suas listas por endereço de e-mail. Ao pesquisar por e-mail, você recebe uma lista de todos os clientes potenciais vinculados a este endereço de e-mail. 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 e-mail 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)
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.

Alterar status do destinatárioGratuito

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 e-mail 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)
Novo status do destinatário. Pode conter Ativo, Pausado, Finalizado, Descadastrado, Respondido automaticamente, Respondido, Respondido de outro e-mail. 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)
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.

Adicionar URL para buscar cliente potencial1 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 rede social do cliente potencial. Especifique o nome da rede social entre [brackets] (LinkedIn ou Twitter).
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)
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.

Obter cliente potencial com URLGratuito

Forneça a URL de rede social do cliente potencial, e o Snov.io retornará as informações completas dele com os endereços de e-mail 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 rede social do cliente potencial. Especifique o nome da rede social entre [brackets] (LinkedIn ou Twitter).
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)
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

Encontrar os campos personalizados do cliente potencialGratuito

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)
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).

Ver listas do usuárioGratuito

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 gotejamento por e-mail.

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)
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).

Verificar saldo do usuárioGratuito

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()
params = {'access_token':token
}

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

return json.loads(res.text)
Resposta
{
    "success": true,
    "data": {
        "balance": "42.00"
    }
}

Parâmetros de saída
balance
Saldo atual do usuário em créditos.

Ver clientes potenciais na listaGratuito

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 e-mail 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
Você pode escolher em que página da lista você deseja terminar sua pesquisa. Este campo é opcional. O valor máximo é 100.
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', data=params)

return json.loads(res.text)
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 e-mails 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 e-mails pertencentes ao cliente potencial.

Ver lista de clientes potenciais concluídosGratuito

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)
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 e-mail do cliente potencial.
campaign
Nome da campanha.

Ver respostas da campanhaGratuito

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.
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)
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 e-mail que recebeu resposta.
emailBody
Conteúdo do e-mail que recebeu resposta.

Ver informações sobre aberturas na campanhaGratuito

Este método mostra as informações sobre os e-mails 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 e-mails você deseja visualizar.
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)
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 e-mail.
emailSubject
Assunto do e-mail que foi aberto.
visitedAt
Horário exato em que o cliente potencial abriu o e-mail.

Ver cliques no linkGratuito

Este método retorna informações sobre todos os destinatários que clicaram em algum link contido nos e-mails 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.
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)
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 e-mail na campanha.
prospectEmail
Endereço de e-mail do cliente potencial.
emailSubject
Assunto do e-mail que continha um link que gerou clique.
emailBody
Conteúdo do e-mail.
visitedAt
Horário exato em que o cliente potencial clicou em um link no e-mail.

Ver e-mails enviadosGratuito

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

Solicitação
GEThttps://api.snov.io/v1/emails-sent
Parâmetros de entrada
campaignId
(necessário)
Identificador exclusivo da campanha cujos e-mails enviados você deseja visualizar.
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)
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 e-mail foi enviado.
userName
Nome completo do cliente potencial ao qual foi enviado o e-mail.
userEmail
Endereço de e-mail do cliente potencial.
campaign
Nome da campanha.

Ver todas as campanhasGratuito

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()
params = {'access_token':token,
        'campaignId':1234567
}

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

return json.loads(res.text)
Resposta
[

    {
        "id": 237945,
        "campaign": "Test",
        "hash": "6467f86496cbc8c69fbf827c1b1df770"
    },
    {
        "id": 237943,
        "campaign": "Test",
        "hash": "c7e2f944bd655f74a4fced201469df29"
    }
]
Parâmetros de saída
id
Identificador exclusivo da campanha do usuário.
campaign
Nome da campanha.