Snov.io API

介绍

我们通过简单的 REST API 提供各种服务功能。与 Snov.io API 集成以同步您的销售线索生成过程。Snov.io API 允许从我们的数据库中检索特定域的电子邮件地址,获取特定域中所有电子邮件的列表,通过名字、姓氏和域查找电子邮件地址以及验证电子邮件。

请注意,API 速率限制为每分钟 60 个请求。

认证

您需要生成访问令牌以认证未来的请求。发出请求时,请在“授权”字段中指定此访问令牌。

Authorization: Bearer QSlHffXmCAILIOHNGXToq4LsP2yX64VQhEBZ7Ei4

这是令牌生成的示例。

请求
POSThttps://app.snov.io/oauth/access_token
输入参数
grant_type
将始终是 "
client_credentials
"
client_id
您的 ID 在帐户设置中可用 https://app.snov.io/api-setting
client_secret
您的密钥在帐户设置中可用 https://app.snov.io/api-setting
代码示例
<?php
function getAccessToken()
{
    $params = [
        'grant_type'    => 'client_credentials',
        'client_id'     => 'c57a0459f6t141659ea75cccb393c5111',
        'client_secret' => '77cbf92b71553e85ce3bfd505214f40b'
    ];

    $options = [
        CURLOPT_URL            => 'https://app.snov.io/oauth/access_token',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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://app.snov.io/oauth/access_token', data=params)
resText = res.text.encode('ascii','ignore')

return json.loads(resText)['access_token']
响应
{
"access_token":"3yUyQZdks0Ej7T2fXzjUWzwlTcO4dWisKkeMpESz",
"token_type":"Bearer",
"expires_in":3600
}
输出参数
access_token
您的新访问令牌
token_type
将始终是 Bearer
expires_in
令牌到期时间(秒)
API 方法
电子邮件数量

免费

使用此 API 方法,您可以在我们的数据库中了解来自某个域的电子邮件地址数量。它完全免费,因此您不需要任何信用点数!

请求
POSThttps://app.snov.io/restapi/get-domain-emails-count
输入参数
domain
您想知道我们数据库中电子邮件数量的域的名称。
代码示例
<?php
function getEmailCount()
{
    $token = getAccessToken();

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

    $options = [
        CURLOPT_URL            => 'https://app.snov.io/restapi/get-domain-emails-count',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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://app.snov.io/restapi/get-domain-emails-count', data=params)

return json.loads(res.text)
响应
{
"domain":"octagon.com",
"webmail":false,
"result":1369
}
输出参数
domain
您想知道我们数据库中电子邮件数量的域的名称。
webmail
是 "
true
"如果您正在搜索的域是网络邮件。
result
我们已找到该域的电子邮件地址总数。我们无法提供网络邮件域的结果,因此网络邮件的结果将始终是
0
.
域搜索

每个请求 2 个信用点数

输入域名,Snov.io 将返回该域上的所有电子邮件地址。
如果数据库中有关于电子邮件所有者的任何其他信息,我们也将添加该信息。
每次响应最多返回 100 个电子邮件。如果没有返回至少一个电子邮件,则不会向您收取该请求的费用。
请求
POSThttps://app.snov.io/restapi/get-domain-emails-with-info
输入参数
domain
您要从中查找电子邮件地址的域的名称。例如,“ snov.io”。
type
它可以包含不同的值 - "
all
", "
personal
" 或 "
generic
"。通用电子邮件地址是基于职务的电子邮件地址,例如 - contact@snov.io.

个人电子邮件地址是在公司工作的实际人员的电子邮件。

limit
设置限制以指定要返回的电子邮件地址的数量。每次响应最多返回 100 个电子邮件地址。
offset
使用抵消功能可以指定要在搜索中跳过的电子邮件地址的数量。默认是
0
.
代码示例
<?php
function getDomainSearch()
{
    $token = getAccessToken();

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

    $options = [
        CURLOPT_URL            => 'https://app.snov.io/restapi/get-domain-emails-with-info',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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://app.snov.io/restapi/get-domain-emails-with-info', data=params)

return json.loads(res.text)
响应
{
"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"
},
...
]
}
输出参数
domain
API 已为其提供电子邮件地址的域名。
webmail
是 "
true
"如果您正在搜索的域是网络邮件。
result
我们已找到该域的电子邮件地址数量。我们无法提供网络邮件域的结果,因此网络邮件的结果始终是
0
.
limit
指定要返回的电子邮件地址的最大数量。
companyName
用于查找电子邮件地址的公司名称。
emails
在搜索中检索到的域电子邮件的数组。
email
在搜索中检索到的特定电子邮件地址。
type
可以包含"
prospect
" 或 "
email
"值。如果返回类型为 "
prospect
",Snov.io 已找到有关电子邮件所有者的其他信息。
status
电子邮件的验证状态。电子邮件的状态可以是"
verified
" 或 "
notVerified
".
firstName
电子邮件所有者的名字。
lastName
电子邮件所有者的姓氏。
position
电子邮件所有者的当前职位。
sourcePage
检索到的个人数据的源页面。
电子邮件验证器

免费

检查提供的电子邮件地址是否有效且可以发送。API 端点将返回电子邮件验证结果。如果我们之前没有验证过某个电子邮件地址,则结果不会返回给您。在这种情况下,API 将返回 “not_verified” 标识符,并且不会向您收取此电子邮件的信用点数。您应该使用添加电子邮件用于验证方法推送此电子邮件地址进行验证,之后您将能够使用此端点获取电子邮件验证结果。

请求
POSThttps://app.snov.io/restapi/get-emails-verification-status
输入参数
emails
您需要验证的电子邮件地址。
代码示例
<?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://app.snov.io/restapi/get-emails-verification-status?' . $emailsQuery,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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://app.snov.io/restapi/get-emails-verification-status?emails[]=gavin.vanrooyen@octagon.com&emails[]=lizi.hamer@octagon.com', data=params)

return json.loads(res.text)
响应
{
"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"
}
}
}

此方法将返回每个请求的电子邮件地址的数据。该响应包含电子邮件验证状态和验证结果。

输出参数
status
电子邮件验证状态。包含标识符和描述。
identifier
可以包含以下值:"
complete
", "
in_progress
", 或 "
not_verified
". 如果标识符为 "
not_verified
", "
data
" 将为空。
description
在这里,您会看到验证状态的文字说明。
data
包含进一步的验证结果 - "
email
", "
isValidFormat
", "
isWebmail
", "
isGibberish
".
email
已验证的电子邮件地址。
isValidFormat
是 "
true
" 如果电子邮件格式正确,即包含正确顺序的有效符号。
isDisposable
是 "
true
"如果我们发现此电子邮件地址来自一次性电子邮件服务。
isWebmail
是 "
true
" 如果此电子邮件地址来自网络邮件。
isGibberish
是 "
true
" 如果此电子邮件地址是自动生成的。
smtpStatus
可以返回 "
valid
", "
not_valid
" 或 "
unknown
". 如是值为 "
unknown
"我们无法提供此电子邮件地址的 SMTP 状态。
添加电子邮件用于验证

每个电子邮件地址 0.5 个信用点数

如果您以前从未验证过某个电子邮件地址,则应使用此 API 方法将其推送以进行验证。执行此操作后,您可以使用电子邮件验证器.

请求
POSThttps://app.snov.io/restapi/add-emails-to-verification
输入参数
emails
您需要添加到验证队列的电子邮件地址列表。每个请求最多可以包含 10 个电子邮件。
代码示例
<?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://app.snov.io/restapi/add-emails-to-verification?' . $emailsQuery,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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://app.snov.io/restapi/add-emails-to-verification?emails[]=gavin.vanrooyen@octagon.com&emails[]=lizi.hamer@octagon.com', data=params)

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

如果将电子邮件地址成功添加到队列中,则该方法返回 "sent":true.

电子邮件查找器

每个请求 1 个信用点数

该 API 方法使用此人的名字和姓氏以及域名来查找电子邮件地址。如果我们的数据库中没有此电子邮件地址,我们将无法立即向您提供结果。为了加快这一过程,您可以使用添加名称以查找电子邮件方法以推送此电子邮件地址进行搜索。之后,再次尝试使用电子邮件查找器方法。

请求
POSThttps://app.snov.io/restapi/get-emails-from-names
输入参数
firstName
电子邮件所有者的名字。
lastName
电子邮件所有者的姓氏。
domain
电子邮件地址中使用的公司的域名。
代码示例
<?php
function getEmailFinder()
{
    $token = getAccessToken();

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

    $options = [
        CURLOPT_URL            => 'https://app.snov.io/restapi/get-emails-from-names',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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://app.snov.io/restapi/get-emails-from-names', data=params)

return json.loads(res.text)
响应
{
"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"
}
}
输出参数
status
使用此对象中的值来检测流程的状态。
identifier
可以包含以下值:"
complete
", "
in_progress
", 或 "
not_found
"。如果标识符为 "
not_found
"响应将包含一个空数组的电子邮件。
description
在这里,您将看到有关电子邮件查找状态的文字说明。
data
包含搜索结果。
firstName
电子邮件所有者的名字。
lastName
电子邮件所有者的姓氏。
emails
电子邮件地址及其状态的数组。值 "
emailStatus
" 可以包含: "
valid
" 或 "
unknown
".
添加名称以查找电子邮件

每个请求 1 个信用点数

如果 Snov.io 在数据库中没有您要查找的电子邮件,并且无法提供这些电子邮件地址(通过电子邮件查找器),您可以尝试使用此方法推送电子邮件搜索请求。如果找到电子邮件,则可以通过电子邮件查找器再次免费请求进行收集。

请求
POSThttps://app.snov.io/restapi/add-names-to-find-emails
请求
firstName
电子邮件所有者的名字。
lastName
电子邮件所有者的姓氏。
domain
电子邮件地址中使用的公司的域名。
代码示例
<?php
function getAddNamesToFindEmails()
{
    $token = getAccessToken();

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


    $options = [
        CURLOPT_URL            => 'https://app.snov.io/restapi/add-names-to-find-emails',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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://app.snov.io/restapi/add-names-to-find-emails', data=params)

return json.loads(res.text)
响应
{
"firstName":"gavin",
"lastName":"vanrooyen",
"domain":"octagon.com",
"sent":true
}

如果将电子邮件请求成功添加到队列中,则该方法返回"sent":true.

获取含有电子邮件的资料

每个请求 1 个信用点数

提供一个电子邮件地址,Snov.io 将从数据库中返回连接到提供的电子邮件地址所有者的所有配置文件信息。
如果我们在数据库中找不到有关电子邮件所有者的信息,则不会向您收取该请求的费用。
请求
POSThttps://app.snov.io/restapi/get-profile-by-email
输入参数
email
您想要查找其他信息的人的电子邮件地址。
代码示例
<?php
function getProfileByEmail()
{
    $token = getAccessToken();

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

    $options = [
        CURLOPT_URL            => 'https://app.snov.io/restapi/get-profile-by-email',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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://app.snov.io/restapi/get-profile-by-email', data=params)

return json.loads(res.text)
响应
{
"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"
}
输出参数
id
唯一的配置文件标识符。
source
检索到的个人数据的来源。
name
电子邮件所有者的全名。
firstName
此人的名字。
lastName
此人的姓氏。
logo
此人的资料照片。
industry
源中显示的此人所在行业。
country
源中显示的此人所在国家/地区。
locality
源中显示的此人所在地点。
social
链接到此人的社交资料。
currentJobs
包含有关此人当前工作职位信息的数组。
previousJobs
一个包含有关此人以前工作职位信息的数组。
lastUpdateDate
数据库中最后一份资料的更新日期。
将潜在客户添加到列表

免费

将潜在客户添加到特定列表。对于希望将潜在客户自动添加到列表中以进行电子邮件水滴营销的人士,这种方法非常实用。在将潜在客户自动添加到所选列表之后,便会自动开始电子邮件水滴营销。

请求
POSThttps://app.snov.io/restapi/add-prospect-to-list
输入参数
email
(必需)
潜在客户电子邮件地址。
fullName
潜在客户全名。
firstName
潜在客户名字。
lastName
潜在客户姓氏。
country
潜在客户国家。国家名称在这里定义:此处。请仅使用此列表中的国家
locality
潜在客户所在地点。
position
潜在客户职务。
companyName
潜在客户公司名称。
companySite
潜在客户公司网站。请使用
http://example.com
格式。
updateContact
更新现有的潜在客户。可以包含 "
true
", 或 "
false
".如果"
true
"并且其中一个列表中已经存在具有此电子邮件地址的潜在客户,系统将更新现有的配置文件。如果 "
false
",系统将不会更新现有的配置文件。
customFields[phone number]
您可以添加自己的自定义字段。在 [brackets] 中指定自定义字段的名称。
social[linkedin]
指向潜在客户的社交媒体资料的链接。在 [brackets] 中指定社交网络的名称(领英、脸书或推特)
listId
(必需)
潜在客户所属列表的标识符。
代码示例
<?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',
        'social[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://app.snov.io/restapi/add-prospect-to-list',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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',
          'social[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://app.snov.io/restapi/add-prospect-to-list', data=params)

return json.loads(res.text)
响应
{
    "success": true,
    "response": {
        "id": "0Y2QzowWL1rHpIptwaRp0Q==",
        "added": true,
        "updated": false,
        "errors": ""
    }
}
输出参数
success
是 "
true
"如果潜在客户已成功添加到列表中。
id
添加潜在客户标识符。
added
是 "
true
"如果潜在客户已添加到列表中。
updated
是 "
true
"如果现有潜在客户的数据已更新。
errors
将潜在客户添加到列表中时出错。
通过 ID 查找潜在客户

免费

根据 ID 从您的列表中找到潜在客户。了解特定潜在客户的 ID 之后,您可以获得有关该潜在客户的完整信息,包括已添加到这些潜在客户的列表和营销。

请求
POSThttps://app.snov.io/restapi/get-prospect-by-id
输入参数
Id
(必需)
潜在客户的 ID。您可以在响应中看到它当您添加一个潜在客户通过将潜在客户添加到列表API 方法或网址当您查看潜在客户页面时(参见一个示例).
代码示例
<?php
function getProspectById()
{
    $token = getAccessToken();

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

    $options = [
        CURLOPT_URL            => 'https://app.snov.io/restapi/get-prospect-by-id',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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://app.snov.io/restapi/get-prospect-by-id', data=params)

return json.loads(res.text)
响应
{
  "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": []
  }
}
输出参数
success
是 "
true
"如果已经找到潜在客户
id
唯一的配置文件标识符
name
潜在客户全名
firstName
潜在客户名字
lastName
潜在客户姓氏
industry
潜在客户资料中显示的行业
country
潜在客户所在国家
locality
潜在客户所在地点
social
链接到潜在客户的社交资料
currentJobs
数组包含有关潜在客户当前职务的信息
previousJobs
数组包含有关潜在客户以前职务的信息
lastUpdateDate
上次资料更新日期
lists
已添加潜在客户的列表
campaigns
此潜在客户已作为收件人添加到的营销列表。包含简短的统计信息,如状态、发出的邮件数量、打开数和回复数。
通过电子邮件查找潜在客户

免费

通过电子邮件地址从您的列表中查找潜在客户。当您通过电子邮件搜索时,您会收到与此电子邮件地址关联的所有潜在客户列表。列表中的每个元素都包含潜在客户的完整信息,包括他们添加到的列表和营销。

请求
POSThttps://app.snov.io/restapi/get-prospect-by-email
输入参数
email
(必需)
潜在客户电子邮件地址。
代码示例
<?php
function getProspectsByEmail()
{
    $token = getAccessToken();

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

    $options = [
        CURLOPT_URL            => 'https://app.snov.io/restapi/get-prospects-by-email',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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://app.snov.io/restapi/get-prospects-by-email', data=params)

return json.loads(res.text)
响应
{
  "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": []
    }
  ]
}
输出参数
success
是 "
true
"如果已经找到潜在客户
id
唯一的配置文件标识符
name
潜在客户全名
firstName
潜在客户名字
lastName
潜在客户姓氏
industry
潜在客户资料中显示的行业
country
潜在客户所在国家
locality
潜在客户所在地点
social
链接到潜在客户的社交资料
currentJobs
数组包含有关潜在客户当前职务的信息
previousJobs
数组包含有关潜在客户以前职务的信息
lastUpdateDate
上次资料更新日期
lists
已添加潜在客户的列表
campaigns
此潜在客户已作为收件人添加到的营销列表。包含简短的统计信息,如状态、发出的邮件数量、打开数和回复数。
更改收件人状态

免费

更改特定营销中收件人的状态。

请求
POSThttps://app.snov.io/restapi/change-recipient-status
输入参数
email
(必需)
潜在客户电子邮件地址。
campaign_id
(必需)
营销 id。查看营销信息时可以在网址里找到(show an example).
status
(必需)
收件人的新状态。可以包含已启用、已暂停、已完成、已退订、已自动回复、回已复、已从另一个电子邮件地址回复。如果收件人的状态为“已完成”或“已移动”,则无法更改其状态。
代码示例
<?php
function changeRecipientStatus()
{
    $token = getAccessToken();

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


    $options = [
        CURLOPT_URL            => 'https://app.snov.io/restapi/change-recipient-status',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => 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://app.snov.io/restapi/change-recipient-status', data=params)

return json.loads(res.text)
响应
{
  "success": true
}
输出参数

方法返回 "success: true"如果潜在客户的状态已成功更改。如果发生任何错误,方法将返回"success: false"和错误描述。