Snov.io API

Our service's features are available with our simple REST API. Integrate with Snov.io API to sync your leads and manage prospects. Snov.io API allows to get a list of all emails from a particular domain, find email addresses by name and domain, verify emails, add prospects to a list, change a recipient's status and more.

Note, the API rate is limited to 60 requests per minute.

Authentication

You need to generate an access token to authenticate future requests. When making a request, please specify this access token in the Authorization field.

Authorization: Bearer QSlHffXmCAILIOHNGXToq4LsP2yX64VQhEBZ7Ei4

Here is an example for token generation.

Request

POST	https://api.snov.io/v1/oauth/access_token

Input Parameters

grant_type	Will always be " client_credentials "
client_id	Your id is available in the account settings https://app.snov.io/api-setting
client_secret	Your secret key is available in the account settings https://app.snov.io/api-setting

Code examples

<?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']

Response

{

"access_token":"3yUyQZdks0Ej7T2fXzjUWzwlTcO4dWisKkeMpESz",

"token_type":"Bearer",

"expires_in":3600

}

Output Parameters

access_token	Your new access token
token_type	Will always be Bearer
expires_in	Token expiration time (in seconds)

API methods

Email count
Free

With this API method, you can find out the number of email addresses from a certain domain in our database. It`s completely free, so you don`t need credits to use it!

Request

POST	https://api.snov.io/v1/get-domain-emails-count

Input Parameters

domain

The name of the domain for which you`d like to know the number of emails in our database.

Code examples

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

Response

{

"domain":"octagon.com",

"webmail":false,

"result":1369

}

Output Parameters

domain	The name of the domain for which you`d like to know the number of emails in our database.
webmail	Is " true " if the domain you`re searching is webmail.
result	A total number of email addresses we have found for this domain. We can`t provide results for webmail domains, so the result for webmail will always be 0 .

Domain search
2 credits per request

Enter a domain name and Snov.io will return all the email addresses on the domain.

If there is any additional information about the email owner available in the database, we will add it as well.

Each response returns up to 100 emails. If it does not return at least one email, you will not be charged for the request.

Request

POST	https://api.snov.io/v1/get-domain-emails-with-info

Input Parameters

domain	The name of the domain from which you want to find the email addresses. For example, "snov.io".
type	It can contain different values - " all ", " personal " or " generic " . A generic email address is a role-based email address, for example - contact@snov.io. A personal email address is the email of the actual person working at the company.
limit	Set the limit to specify the number of email addresses to return. Each response returns up to 100 email addresses.
offset	Use offset to specify the number of email addresses to skip in the search. The default is 0 .

Code examples

<?php
function getDomainSearch()
{
    $token = getAccessToken();

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

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

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

return json.loads(res.text)

Response

{

"domain":"octagon.com",

"webmail":false,

"result":100,

"limit":100,

"companyName":"Octagon",

"emails":[

{

"email":"ben.gillespie@octagon.com",

"type":"prospect",

"status":"verified",

"firstName":"Ben",

"lastName":"Gillespie",

"position":"Senior Account Executive",

"sourcePage":"https://www.linkedin.com/pub/ben-gillespie/7/73/809"

...

]

}

Output Parameters

domain	The domain name for which the API has provided the email addresses.
webmail	Is " true " if the domain you`re searching is webmail.
result	The number of email addresses we have found for this domain. We can`t provide results for webmail domains, so the result for webmail will always be 0 .
limit	Specifies the maximum number of email addresses to return.
companyName	The company name used to find the email addresses.
emails	The array of domain emails retrieved in the search.
email	A specific email address retrieved in the search.
type	Can contain " prospect " or " email " values. If the returned type is " prospect " , Snov.io found additional information about the email owner.
status	Email`s verification status. Email`s status can be " verified " or " notVerified ".
firstName	The email owner`s first name.
lastName	The email owner`s last name.
position	The email owner`s current job position.
sourcePage	The source page of retrieved personal data.

Email verifier
Free

Check if the provided email addresses are valid and deliverable. API endpoint will return the email verification results. If we haven’t verified a certain email address before, the results will not be returned to you. In this case, the API will return a “not_verified” identifier and you will not be charged credits for this email. You should use the Add emails for verification method to push this email address for verification, after which you will be able to get the email verification results using this endpoint.

Request

POST	https://api.snov.io/v1/get-emails-verification-status

Input Parameters

emails

The email addresses you need to verify.

Code examples

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

Response

{

"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"

}

This method will return data for each requested email address. The response contains an email verification status and verification results.

Output Parameters

status	The Email verification status. Contains identifier and description.
identifier	Can contain the following values: " complete ", " in_progress ", or " not_verified ". If the identifier is " not_verified ", " data " will be empty.
description	Here you will see a text description of the verification status.
data	Contains further verification results - " email ", " isValidFormat ", " isWebmail ", " isGibberish ".
email	The email address that has been verified.
isValidFormat	Is " true " if the format of email is correct, i.e. it contains valid symbols in the correct order.
isDisposable	Is " true " if we find that this email address is from a disposable email service.
isWebmail	Is " true " if this email address is from a webmail.
isGibberish	Is " true " if this email address has been automatically generated.
smtpStatus	Can return " valid ", " not_valid ", " greylisted " or " unknown " (aka Unverifiable). You can learn more about email statuses here.

If you get a "

greylisted

" smtpStatus, it means we are temporarily unable to verify this email and will continue attempts to validate it.
You can resubmit this API request after a short break (usually from 15 minutes to 1 hour) to receive correct results.
Note that we don't charge for emails with "

greylisted

" status until we finish validating them and receive a definitive SMTP status - "

valid

" or "

not_valid

Add emails for verification
0.5 credit per email address

If you've never verified a certain email address before, you should push it for verification using this API method. After performing this action, you can receive the verification results using the Email verifier.

Request

POST	https://api.snov.io/v1/add-emails-to-verification

Input Parameters

emails

A list of email addresses you need to add to the verification queue. Each request can contain up to 10 emails.

Code examples

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

Response

{

"gavin.vanrooyen@octagon.com":{

"sent":true

"lizi.hamer@octagon.com":{

"sent":true

}

If an email address is successfully added to the queue, the method returns "sent":true.

Email finder
1 credit per request

This API method finds email addresses using the person`s first and last name, and a domain name. If we don`t have this email address in our database, we won`t be able to provide the results to you right away. To speed up the process, you can use the Add Names To Find Emails method to push this email address for search. After that, try the Email Finder method again.

Request

POST	https://api.snov.io/v1/get-emails-from-names

Input Parameters

firstName	The email address owner`s first name.
lastName	The email address owner`s last name.
domain	The domain name of the company that is used in the email address.

Code examples

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

Response

{

"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"

}

Output Parameters

status	Use the values in this object to detect the status of the process.
identifier	Can contain the following values: " complete ", " in_progress ", or " not_found ". If the identifier is " not_found ", the response will contain an empty array of emails.
description	Here you will see a text description of the email finding status.
data	Contains the search result.
firstName	The email address owner`s first name.
lastName	The email address owner`s last name.
emails	The array of email addresses with their statuses. Value " emailStatus " can contain: " valid " or " unknown ".

Add names to find emails
1 credit per request

If Snov.io does not have the emails you are looking for in its database and can't provide these email addresses via the Email finder, you can try to push the request for email search using this method. If an email is found, you can collect it by using the free Email finder request again.

Request

POST	https://api.snov.io/v1/add-names-to-find-emails

Request

firstName	The email address owner`s first name.
lastName	The email address owner`s last name.
domain	The domain name of the company that is used in the email address.

Code examples

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

Response

{

"firstName":"gavin",

"lastName":"vanrooyen",

"domain":"octagon.com",

"sent":true

}

If the email request was successfully added to the queue, the method returns "sent":true.

Get profile with email
1 credit per request

Provide an email address and Snov.io will return all the profile information connected to the provided email address owner from the database.

If we find no information about the email owner in our database, you will not be charged for the request.

Request

POST	https://api.snov.io/v1/get-profile-by-email

Input Parameters

The email address of the person you want to find additional information on.

Code examples

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

Response

{
"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"
}

Output Parameters

id	A unique profile identifier.
source	The source of retrieved personal data.
name	The email address owner`s full name.
firstName	The person`s first name.
lastName	The person`s last name.
logo	The person`s profile photo.
industry	The person`s industry as indicated in the source.
country	The person`s country as indicated in the source.
locality	The person`s locality as indicated in the source.
social	Links to the person`s social profiles.
currentJobs	An array containing information about the person`s current job position(s).
previousJobs	An array containing information about the person`s previous job position(s).
lastUpdateDate	The date of the last profile update in the database.

Add prospect to list
Free

Add prospect to a specific list. This method will be useful for those who want to automate adding prospects to lists with active email drip campaigns. This way after a prospect is automatically added to a chosen list, an email drip campaign will be started for them automatically.

Request

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

Input Parameters

email (Required)	The prospect’s email address.
fullName	The prospect’s full name.
firstName	The prospect’s first name.
lastName	The prospect’s last name.
country	The prospect’s country. The country names are defined here. Please, only use countries from this list.
locality	The prospect’s locality.
position	The prospect’s job title.
companyName	The name of the prospect’s company.
companySite	The prospect’s company website. Please, use the http://example.com format.
updateContact	Updates an existing prospect. Can contain " true ", or " false ". If " true " and a prospect with this email address already exists in one of the lists, the system will update the existing profile. If " false " , the system will not update the existing profile.
customFields[phone number]	You can add your own custom fields. Specify the name of the custom field in the [brackets].
socialLinks[linkedIn]	A link to the prospect’s social media profile. Specify the name of the social network in the [brackets] (LinkedIn, Facebook, or Twitter).
listId (Required)	The identifier of the list the prospect belongs to.

Code examples

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

Response

{
    "success": true,
    "response": {
        "id": "0Y2QzowWL1rHpIptwaRp0Q==",
        "added": true,
        "updated": false,
        "errors": ""
    }
}

Output Parameters

success	Is " true " if the prospect was successfully added to the list.
id	Added prospect’s identifier.
added	Is " true " if the prospect was added to the list.
updated	Is " true " if the existing prospect’s data has been updated.
errors	There’s been an error in adding the prospect to the list.

Find prospect by ID
Free

Find prospects from your lists by id. Knowing the id of a specific prospect you can get full information on the prospect, including the lists and campaigns they’ve been added to.

Request

POST	https://api.snov.io/v1/get-prospect-by-id

Input Parameters

(Required)

The prospect’s id. You can see it in the response when you add a prospect via Add prospect to list API method or in the URL when you view prospect’s page (see an example).

Code examples

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

Response

{
  "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": []
  }
}

Output Parameters

success	Is " true " if the prospect was found
id	Unique profile identifier
name	Prospect’s full name
firstName	Prospect’s first name
lastName	Prospect’s last name
industry	Industry as indicated in the prospect’s profile
country	Prospect’s country
locality	Prospect’s locality
social	Links to prospect’s social profiles
currentJobs	Array contains information about the prospect’s current job title
previousJobs	Array contains information about the prospect’s previous job titles
lastUpdateDate	Date of last profile update
lists	Lists that the prospect has been added to
campaigns	List of campaigns this prospect has been added to as a recipient. Contains short statistics such as status, number of sent messages, opens and replies.

Find prospect by email
Free

Find prospect from your lists by email address. When you search by email, you receive a list of all prospects tied to this email address. Every element of the list contains full information on the prospect, including the lists and campaigns they’ve been added to.

Request

POST	https://api.snov.io/v1/get-prospects-by-email

Input Parameters

(Required)

The prospect’s email address.

Code examples

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

Response

{
  "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": []
    }
  ]
}

Output Parameters

success	Is " true " if the prospect was found
id	Unique profile identifier
name	Prospect’s full name
firstName	Prospect’s first name
lastName	Prospect’s last name
industry	Industry as indicated in the prospect’s profile
country	Prospect’s country
locality	Prospect’s locality
social	Links to prospect’s social profiles
currentJobs	Array contains information about the prospect’s current job title
previousJobs	Array contains information about the prospect’s previous job titles
lastUpdateDate	Date of last profile update
lists	Lists that the prospect has been added to
campaigns	List of campaigns this prospect has been added to as a recipient. Contains short statistics such as status, number of sent messages, opens and replies.

Change recipient’s status
Free

Change the status of a recipient in a specific campaign.

Request

POST	https://api.snov.io/v1/change-recipient-status

Input Parameters

email (Required)	The prospect’s email address.
campaign_id (Required)	The campaign’s id. You can find it in the URL when you view the campaign info (show an example).
status (Required)	New status for the recipient. Can contain Active, Paused, Finished, Unsubscribed, Auto-replied, Replied, Replied from another email. You can not change the recipients' status if their status is Finished or Moved.

Code examples

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

Response

{
  "success": true
}

Output Parameters

Method returns "success: true" if the prospect’s status has been successfully changed. If any error occurs, the method will return "success: false" with an error description.

Add URL to search for prospect
1 credit per request

Find prospects by social URL. To receive the results, use the Get prospect with URL method.

Request

POST	https://api.snov.io/v1/add-url-for-search

Input Parameters

url	A link to the prospect’s social media profile. Specify the name of the social network in the [brackets] (LinkedIn or Twitter).

Code examples

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

Response

{
  "success": true
}

Output Parameters

success	Is " true " if the prospect was successfully added to findlist.
message	There’s been an error in adding the prospect to the list.

Get prospect with URL
Free

Provide the prospect's social URL and Snov.io will return the full information on the prospect with the found email addresses. You should previously use the Add URL to search for prospect method. Otherwise, the result will not be shown.

Request

POST	https://api.snov.io/v1/get-emails-from-url

Input Parameters

url	A link to the prospect’s social media profile. Specify the name of the social network in the [brackets] (LinkedIn or Twitter).

Code examples

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

Response

{
  "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"
            }
        ]
    }
  ]
}

Output Parameters

success	Is " true " if the prospect was found
id	Unique profile identifier
name	Prospect’s full name
firstName	Prospect’s first name
lastName	Prospect’s last name
industry	Industry as indicated in the prospect’s profile
country	Prospect’s country
locality	Prospect’s locality
skills	Prospect's skills
social	Links to prospect’s social profiles
currentJobs	Array contains information about the prospect’s current job title
previousJobs	Array contains information about the prospect’s previous job titles
lastUpdateDate	Date of last profile update
emails	Prospect's email with actual status

Find prospect’s custom fields
Free

This method returns a list of all custom fields created by the user, including the fields’ name, whether the field is optional or required, and the field’s data type.

Request

GET	https://api.snov.io/v1/prospect-custom-fields

Input Parameters

There’s no input parameters for this method

Code examples

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

Response

  [
    {
        "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"
    }
  ]

Output Parameters

key	The field’s key in the customFields array.
label	The field’s name.
required	Is " true " if the custom field is required
type	The custom field’s data type (string, number, or date).

See user lists
Free

This method returns all lists created by the user. You can use this method to review lists that can be used for an email drip campaign.

Request

GET	https://api.snov.io/v1/get-user-lists

Input Parameters

There’s no input parameters for this method

Code examples

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

Response

[
    {
        "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"
        }
    }
]

Output Parameters

Id	User’s list unique identifier.
Name	List name
Contacts	The number of prospects in the list.
isDeleted	List’s status. Is " true " if the list has been deleted.
CreationDate	The date and time of list creation (includes date, time, and time zone info).
deleteDate	If the list has been deleted, contains the date and time of list deletion (includes date, time, and time zone info).

Check user balance
Free

Use this method to check your credit balance.

Request

GET	https://api.snov.io/v1/get-balance

Input Parameters

There’s no input parameters for this method

Code examples

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

Response

{
    "success": true,
    "data": {
        "balance": "42.00"
    }
}

Output Parameters

Balance

User’s current balance in credits.

View prospects in list
Free

This method returns all the data on prospects in a specific list, including prospect’s data like email addresses and their status.

Request

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

Input Parameters

listId (Required)	The list’s unique identifier.
page	You can choose on which page of the list you would like to begin your search. This field is optional.
perPage	You can choose on which page of the list you would like to end your search. This field is optional. Maximum value is 100.

Code examples

<?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.get('https://api.snov.io/v1/prospect-list', data=params)

return json.loads(res.text)

Response

Please note, the prospect results are displayed in reverse order from last to first.

{
    "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
                }
            ]
        }
    ]
}

Output Parameters

list	An array with information about the list and the prospects in it.
name	The name of the list.
contacts	The number of prospects in the list.
creation_date	The date of list creation (includes date, time, and time zone info).
emailsCount	The number of emails in the list.
prospects	A list of prospects in the list.
id	A prospect’s unique identifier.
name	A prospect’s full name.
emails	A list of emails belonging to the prospect.

See list of completed prospects
Free

This method returns prospects for whom the campaign has been completed.

Request

GET	https://api.snov.io/v1/prospect-finished

Input Parameters

campaignId

(Required)

campaign id to get the prospects list

Code examples

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

Response

[
    {
        "id": "88c268d404797d1001b4d72806207625",
        "prospectId": "9c2eb5b46bb5873e408684dd577d002354e4f7026f47bf8a592d659bba3d2dd0ff186b90dc7a5",
        "userName": "zach Jones",
        "userEmail": "zach@entselect.us",
        "campaign": "Zipari - Salesforce Developer",
        "hash": "f3967971cbab6e769b5f7e3457d00159"
    }
]

Output Parameters

id	special identifier
prospectId	prospect identifier
userName	prospect full name
userEmail	prospect email
campaign	campaign name

See campaign replies
Free

This method returns the campaign replies with all the information, including the prospect’s name, ID, campaign, etc.

Request

GET	https://api.snov.io/v1/get-emails-replies

Input Parameters

campaignId

(Required)

campaign id to get replies from it

Code examples

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

Response

[
    {
        "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_рпа": ""
    }
]

Output Parameters

campaignId	campaign id
campaign	campaign name
prospectName	prospect full name
emailSubject	Email subject
emailBody	Email content

Get info about campaign opens
Free

This method shows the information about the opened emails in the campaign.

Request

GET	https://api.snov.io/v1/get-emails-opened

Input Parameters

campaignId

(Required)

campaign id to get replies from it

Code examples

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

Response

[
    {
        "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": ""
    }
]

Output Parameters

campaignId	campaign id
campaign	campaign name
prospectName	prospect full name
emailSubject	Email subject
visitedAt	open time

Check link clicks
Free

This method returns information on all campaign recipients that have clicked a link in one of campaign emails.

Request

GET	https://api.snov.io/v1/get-emails-clicked

Input Parameters

campaignId

(Required)

campaign id to get replies from it

Code examples

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

Response

[
    {
        "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": ""
    }
]

Output Parameters

campaignId	campaign id
campaign	campaign name
prospectName	prospect full name
prospectEmail	prospect email
emailSubject	Email subject
emailBody	Email content
visitedAt	open time

View user's campaigns
Free

This method shows the list of all user campaigns.

Request

GET	https://api.snov.io/v1/get-user-campaigns

Input Parameters

There’s no input parameters for this method

Code examples

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

Response

[

    {
        "id": 237945,
        "campaign": "Test",
        "hash": "6467f86496cbc8c69fbf827c1b1df770"
    },
    {
        "id": 237943,
        "campaign": "Test",
        "hash": "c7e2f944bd655f74a4fced201469df29"
    }
]

Output Parameters

id	campaign id
campaign	campaign name

Snov.io API

Authentication

API methods

Email countFree

Domain search2 credits per request

Email verifierFree

Add emails for verification0.5 credit per email address

Email finder1 credit per request

Add names to find emails1 credit per request

Get profile with email1 credit per request

Add prospect to listFree

Find prospect by IDFree

Find prospect by emailFree

Change recipient’s statusFree

Add URL to search for prospect1 credit per request

Get prospect with URLFree

Find prospect’s custom fieldsFree

See user listsFree

Check user balanceFree

View prospects in listFree

See list of completed prospectsFree

See campaign repliesFree

Get info about campaign opensFree

Check link clicksFree

View user's campaignsFree

Email count
Free

Domain search
2 credits per request

Email verifier
Free

Add emails for verification
0.5 credit per email address

Email finder
1 credit per request

Add names to find emails
1 credit per request

Get profile with email
1 credit per request

Add prospect to list
Free

Find prospect by ID
Free

Find prospect by email
Free

Change recipient’s status
Free

Add URL to search for prospect
1 credit per request

Get prospect with URL
Free

Find prospect’s custom fields
Free

See user lists
Free

Check user balance
Free

View prospects in list
Free

See list of completed prospects
Free

See campaign replies
Free

Get info about campaign opens
Free

Check link clicks
Free

View user's campaigns
Free