Функции нашей платформы доступны в простом интерфейсе REST API. Интегрируйте ваш проект со Snov.io API для синхронизации лидов и управления контактами. Snov.io API позволяет получить список email-адресов с определенного домена, найти email-адреса по имени или домену, проверить email-адреса на валидность, добавить контакты в список, изменить статус получателя и многое другое.
Обратите внимание, что пропускная способность API — 60 запросов в минуту.
Для аутентификации будущих запросов необходимо сгенерировать токен доступа. Отправляя запрос, укажите токен доступа в поле авторизации.
Authorization: Bearer QSlHffXmCAILIOHNGXToq4LsP2yX64VQhEBZ7Ei4 |
Вот пример генерации токена.
POST | https://api.snov.io/v1/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://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']
{ | |||
| |||
} |
access_token | Ваш новый токен доступа. |
token_type | Всегда Bearer |
expires_in | Срок действия токена (в секундах). |
Этот метод API позволяет узнать, какое количество email-адресов с определенного домена содержится в нашей базе данных. Услуга абсолютно бесплатна, кредиты не используются.
POST | https://api.snov.io/v1/get-domain-emails-count |
domain | Имя домена, количество адресов с которого вы хотите узнать. |
<?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)
{ | ||||
| ||||
} |
domain | Имя домена, количество адресов с которого вы хотите узнать. |
webmail | Будет " true "если домен, который вы выбрали, является сайтом электронной почты. |
result | Общее количество email-адресов, найденных нами для этого домена. Мы не можем предоставить результаты для сайтов электронной почты, потому для них результат всегда 0 . |
GET | https://api.snov.io/v2/domain-emails-with-info |
domain | Имя домена, на котором вы хотите найти email-адреса. Например, snov.io. |
type | Может содержать разные значения: " all ", "personal " или "generic ". Общий адрес электронной почты связан с функцией сотрудников, которые его используют, например contact@snov.io.Личный адрес электронной почты — это адрес конкретного сотрудника компании. |
limit | Используйте это поле, чтобы указать количество адресов, которые хотите получить. Каждый запрос возвращает до 100 адресов. |
lastId | Чтобы собрать больше email-адресов, чем указано во входящем параметре Limit, в следующем запросе укажите id последнего собранного адреса из предыдущего запроса. Таким образом, ранее собранные email-адреса будут пропущены. Обратите внимание, что параметр lastId — обязателен. Значение по умолчанию — 0 . |
<?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)
{ "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" } ] }
domain | Имя домена, для которого API нашел email-адреса. |
webmail | Будет " true " если домен, который вы выбрали, используется службой электронной почты. |
result | Количество email-адресов, найденных нами для этого домена. Мы не можем предоставить результаты для сайтов электронной почты, потому для них результат всегда 0 . |
limit | Максимальное количество адресов, возвращенных в ответ на запрос. |
companyName | Название компании, использованное для поиска адресов. |
emails | Адреса с домена, найденные при поиске. |
email | Конкретный адрес электронной почты, полученный в результате поиска. |
type | Может иметь значения " prospect " или "email ". Если возвращенное значение "prospect ", значит Snov.io нашел дополнительную информацию о владельце email-адреса. |
status | Статус проверки email-адреса. Может быть " verified " или "notVerified ". |
firstName | Имя владельца email-адреса. |
lastName | Фамилия владельца email-адреса. |
position | Должность, которую владелец email-адреса занимает в настоящий момент. |
sourcePage | Страница, на которой были найдены персональные данные. |
lastId | Id последнего собранного email-адреса из предыдущего ответа. |
Убедитесь, что полученные адреса электронной почты действительны и письмо, отправленное по ним, может быть доставлено. Конечная точка API вернет результаты проверки адреса. Если мы не проверяли этот email-адрес ранее, API вернет идентификатор «not_verified», и кредиты за такой адрес не снимутся. Используйте метод Добавить адреса для проверки, чтобы передать этот адрес на проверку, после чего вы сможете получить результаты проверки, используя эту конечную точку.
POST | https://api.snov.io/v1/get-emails-verification-status |
emails | Email-адреса, которые нужно проверить. |
<?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)
{ | |||||||||||||||||
| |||||||||||||||||
| |||||||||||||||||
} |
Этот метод вернет данные по каждому адресу, указанному в запросе. Ответ содержит статус и результаты проверки адреса.
status | Статус проверки адреса. Содержит идентификатор и описание. |
identifier | Может содержать следующие значения: " complete ", "in_progress ", или "not_verified ".. Если идентификатор "not_verified ", "data " будет пустым. |
description | В этом поле будет текстовое описание статуса проверки. |
data | Содержит дополнительную информацию о результатах проверки: " email ", "isValidFormat ", "isWebmail ", "isGibberish ". |
email | Email-адрес, который проверялся. |
isValidFormat | Будет " true ", если формат адреса правильный, то есть содержит допустимые символы в правильном порядке. |
isDisposable | Будет " true ", если установлено, что адрес предоставлен одноразовой службой электронной почты. |
isWebmail | Будет " true ", если адрес предоставлен службой электронной почты. |
isGibberish | Будет " true ", если адрес сгенерирован автоматически. |
smtpStatus | Возможные ответы: " valid ", "not_valid ", "greylisted " или "unknown " (непроверяемый). Вы можете узнать больше об email-статусах здесь. |
Если smtpStatus « greylisted », это значит, что мы временно не можем верифицировать этот email-адрес, но продолжим попытки.Вы можете повторно отправить этот запрос API после небольшой паузы (как правило, от 15 минут до 1 часа), чтобы получить корректные результаты. Обратите внимание, что мы не снимаем плату за статус « greylisted » до того момента, пока не сможем точно определить SMTP-статус как «valid » или «not_valid ». |
Если вы проверяете адрес в первый раз, отправьте его на проверку при помощи этого метода API. Сделав это, вы получите результаты проверки в инструменте Проверка адресов.
POST | https://api.snov.io/v1/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://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)
{ | |||||
| |||||
| |||||
} |
Если адрес электронной почты добавлен в очередь, метод вернет "sent":true.
Этот метод API ищет адреса по имени и фамилии человека и доменному имени. Если адреса нет в нашей базе данных, мы не сможем сразу же предоставить вам результаты поиска. Чтобы ускорить процесс, используйте метод «Добавить имена для поиска адресов», чтобы отправить адрес на проверку. После чего воспользуйтесь инструментом «Поиск адресов» еще раз.
POST | https://api.snov.io/v1/get-emails-from-names |
firstName | Имя владельца email-адреса. |
lastName | Фамилия владельца email-адреса. |
domain | Доменное имя компании, использованное в адресе электронной почты. |
<?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)
{ | |||||||||||||
| |||||||||||||
| |||||||||||||
| |||||||||||||
} |
status | Используйте значения этого объекта, чтобы определить статус процесса. |
identifier | Может содержать следующие значения: " complete ", "in_progress ", или "not_found ". При идентификаторе "not_found " ответ не будет содержать email-адреса. |
description | Текстовое описание статуса поиска адреса. |
data | Содержит результаты поиска. |
firstName | Имя владельца email-адреса. |
lastName | Фамилия владельца email-адреса. |
emails | Массив адресов электронной почты и их статусов. Значение " emailStatus " может содержать: "valid " или "unknown ". |
Если Snov.io не находит искомые адреса в своей базе данных и не может их найти с помощью инструмента Поиск адресов, можно попробовать отправить запрос на поиск адреса, используя этот метод. Если адрес найден, вы можете получить его с помощью бесплатного повторного запроса в инструменте Поиск адресов.
POST | https://api.snov.io/v1/add-names-to-find-emails |
firstName | Имя владельца email-адреса. |
lastName | Фамилия владельца email-адреса. |
domain | Доменное имя компании, использованное в адресе электронной почты. |
<?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)
{ | ||||||
| ||||||
} |
Если адрес электронной почты добавлен в очередь, метод вернет"sent":true.
POST | https://api.snov.io/v1/get-profile-by-email |
email | Адрес электронной почты, принадлежащей лицу, дополнительную информацию о котором вы хотите найти. |
<?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)
{ "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" }
id | Уникальный идентификатор профиля. |
source | Источник полученных персональных данных. |
name | Полное имя владельца email-адреса. |
firstName | Имя. |
lastName | Фамилия. |
logo | Аватар профиля. |
industry | Отрасль, указанная в источнике данных. |
country | Страна, указанная в источнике данных. |
locality | Местоположение, указанное в источнике данных. |
social | Ссылки на профили в соцсетях. |
currentJobs | Массив, который содержит информацию о текущей должности лица. |
previousJobs | Массив, который содержит информацию о предыдущих должностях лица. |
lastUpdateDate | Дата последнего обновления профиля в базе данных. |
Добавьте контакт в определенный список. Этот метод используется, когда необходимо автоматизировать процесс добавления контактов в списки, для которых идет рассылка. Таким образом, после добавления контакта в выбранный список рассылка для него начнется автоматически.
POST | https://api.snov.io/v1/add-prospect-to-list |
email (обязательно) | Адрес электронной почты контакта. |
fullName | Полное имя контакта. |
firstName | Имя контакта. |
lastName | Фамилия контакта. |
country | Страна контакта. Список стран представлен здесь. Просим вас использовать только страны из списка. |
locality | Местоположение контакта. |
position | Должность контакта. |
companyName | Название компании контакта. |
companySite | Сайт компании контакта. Пожалуйста, используйте формат http://example.com . |
updateContact | Обновляет информацию о существующем контакте. Может содержать " true ", или "false ". Если "true "и контакт с таким адресом электронной почты уже есть в одном из списков, система обновит существующий профиль. Если "false ", система не обновит существующий профиль. |
customFields[phone number] | Вы можете добавить кастомные значения в уже существующие кастомные поля. Для этого укажите название поля в [квадратных скобках]. |
socialLinks[linkedIn] | Ссылка на профиль контакта в соцсетях. Укажите название социальной сети в [скобках] (LinkedIn, Facebook или Twitter). |
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', '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)
{ "success": true, "id": "0Y2QzowWL1rHpIptwaRp0Q==", "added": true, "updated": false }
success | Будет " true ", если контакт был добавлен в список. |
id | Добавленный идентификатор контакта. |
added | Будет " true ", если контакт был добавлен в список. |
updated | Будет " true ", если данные существующего контакта обновились. |
errors | При добавлении контакта в список возникла ошибка. |
Найдите контакты в списках по id. Зная id контакта, можно получить полную информацию о нем, включая списки и рассылки, в которые он включен.
POST | https://api.snov.io/v1/get-prospect-by-id |
id (обязательно) | Id контакта. Его можно увидеть в ответе, когда вы добавляете контакт с помощью метода API Добавить контакты в список или в адресной строке, когда просматриваете страницу контакта (пример). |
<?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)
{ "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 | Список рассылок запущенных для контакта. Содержит краткую статистику, например: статус, количество отправленных и открытых писем, и ответов на них. |
Ищите контакты в списках по адресу электронной почты. При поиске по email-адресу вы получаете список всех контактов, привязанных к email-адресу. Каждый элемент в списке содержит полную информацию о контакте, в том числе списки и рассылки, в которые он включен.
POST | https://api.snov.io/v1/get-prospects-by-email |
email (обязательно) | Адрес электронной почты контакта. |
<?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)
{ "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 | Список рассылок запущенных для контакта. Содержит краткую статистику, например: статус, количество отправленных и открытых писем, и ответов на них. |
Измените статус получателя конкретной рассылки.
POST | https://api.snov.io/v1/change-recipient-status |
email (обязательно) | Адрес электронной почты контакта. |
campaign_id (обязательно) | Id рассылки. Его можно увидеть в адресной строке при просмотре информации о рассылке (показать пример). |
status (обязательно) | Новый статус получателя. Возможные статусы: «Active», «Paused», «Finished», «Unsubscribed», «Auto-replied», «Replied», «Replied from another email». Если получателю присвоен статус «Finished» или «Moved», такой статус изменить нельзя. |
<?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)
{ "success": true }
Метод вернет "success: true", если статус контакта был изменен. В случае ошибки метод вернет "success: false" с описанием ошибки.
Находите контакты по профилям в соцсетях. Для дальнейшего получения результатов поиска применяйте метод «Собрать контакт по ссылке на профиль».
POST | https://api.snov.io/v1/add-url-for-search |
url | Ссылка на профиль контакта в соцсетях. Укажите название социальной сети в [таких скобках] (LinkedIn или Twitter). |
<?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)
{ "success": true }
success | Будет " true ", если контакт был добавлен в поисковый список. |
message | При добавлении контакта в список возникла ошибка. |
После использования метода «Добавить ссылку на профиль для поиска контакта», используйте этот метод для получения полной найденной информации о нем включая адрес электронной почты.
POST | https://api.snov.io/v1/get-emails-from-url |
url | Ссылка на профиль контакта в соцсетях. Укажите название социальной сети в [таких скобках] (LinkedIn или Twitter). |
<?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)
{ "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" } ] } ] }
success | Будет " true ", если контакт найден. |
id | Уникальный идентификатор профиля. |
name | Полное имя контакта. |
firstName | Имя контакта. |
lastName | Фамилия контакта. |
industry | Отрасль, указанная в профиле контакта. |
country | Страна контакта. |
locality | Местоположение контакта. |
skills | Навыки контакта. |
social | Ссылки на профили контакта в соцсетях. |
currentJobs | Массив содержит информацию о текущей должности контакта. |
previousJobs | Массив содержит информацию о предыдущих должностях контакта. |
lastUpdateDate | Дата последнего обновления профиля. |
emails | Email-адрес контакта и его актуальный статус. |
Этот метод возвращает список всех кастомных полей, созданных пользователем, в том числе названия полей, параметры, определяющие обязательное это поле или нет, и тип информации внутри поля.
GET | https://api.snov.io/v1/prospect-custom-fields |
Для этого метода отсутствуют необходимые входящие параметры |
<?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)
[ { "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" } ]
key | Ключ поля в массиве customFields . |
label | Название поля. |
required | Будет " true " если кастомное поле обязательное. |
type | Тип данных кастомного поля (строка, число или дата). |
Этот метод возвращает все списки, созданные пользователем. Вы можете использовать этот метод чтобы проверить списки, доступные для триггерных рассылок.
GET | https://api.snov.io/v1/get-user-lists |
Для этого метода отсутствуют необходимые входящие параметры |
<?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)
[ { "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" } } ]
id | Уникальный id списка пользователя. |
name | Название списка. |
contacts | Количество контактов в списке. |
isDeleted | Статус списка. Возвращает " true ", если список был удален. |
creationDate | Дата создания списка (включает информацию о дате, времени и часовом поясе). |
deleteDate | Содержит дату удаления, если список был удален (включая время и часовой пояс). |
Используйте этот метод для проверки баланса кредитов на вашем счету.
GET | https://api.snov.io/v1/get-balance |
Для этого метода отсутствуют необходимые входящие параметры |
<?php function getBalance() { $token = getAccessToken(); $params = [ 'access_token' => $token, ]; $params = http_build_query($params); $options = [ CURLOPT_URL => 'https://api.snov.io/v1/get-balance?'.$params, CURLOPT_RETURNTRANSFER => true, CURLOPT_FOLLOWLOCATION => true ]; $ch = curl_init(); curl_setopt_array($ch, $options); $res = json_decode(curl_exec($ch), true); curl_close($ch); return $res; } ?>
def get_balance(): token = get_access_token() headers = {'authorization':token } res = requests.get('https://api.snov.io/v1/get-balance', headers=headers) return json.loads(res.text)
{ "success": true, "data": { "balance": "42.00" } }
balance | Текущий баланс пользователя в кредитах. |
Этот метод возвращает все данные о контактах в указанном списке, такие как email-адрес и их статус.
POST | https://api.snov.io/v1/prospect-list |
listId (обязательно) | Уникальный id списка. |
page | Вы можете выбрать с какой страницы списка начать поиск. Это поле необязательно. |
perPage | Выберите страницу списка, на которой следует закончить поиск. Это поле необязательно. Максимальное значение — 100. |
<?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)
Обратите внимание: результаты отображаются в обратном порядке, от последнего контакта к первому.
{ "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 } ] } ] }
list | Массив с информацией о списке и контактах, которые он содержит. |
name | Название списка. |
contacts | Количество контактов в списке. |
creation_date | Дата создания списка (включая время и часовой пояс). |
emailsCount | Количество email-адресов в списке. |
prospects | Все контакты в списке. |
id | Уникальный id контакта. |
name | Полное имя контакта. |
emails | Список email-адресов, принадлежащих контакту. |
Этот метод возвращает список контактов, для которых рассылка завершена.
GET | https://api.snov.io/v1/prospect-finished |
campaignId (обязательно) | Уникальный id рассылки для просмотра списка получателей. |
<?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)
[ { "id": "88c268d404797d1001b4d72806207625", "prospectId": "9c2eb5b46bb5873e408684dd577d002354e4f7026f47bf8a592d659bba3d2dd0ff186b90dc7a5", "userName": "zach Jones", "userEmail": "zach@entselect.us", "campaign": "Zipari - Salesforce Developer", "hash": "f3967971cbab6e769b5f7e3457d00159" } ]
id | Уникальный id запроса. |
prospectId | Уникальный id контакта. |
userName | Полное имя получателя. |
userEmail | Email-адрес получателя. |
campaign | Название рассылки. |
Этот метод возвращает информацию об ответах на письма со всеми данными, в том числе именем контакта, id, названием рассылки и др.
GET | https://api.snov.io/v1/get-emails-replies |
campaignId (обязательно) | Уникальный id рассылки для просмотра ответов. |
<?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)
[ { "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_рпа": "" } ]
campaignId | Уникальный id рассылки. |
campaign | Название рассылки. |
prospectName | Полное имя получателя. |
emailSubject | Тема письма, на которое был получен ответ. |
emailBody | Текст письма, на которое был получен ответ. |
Этот метод показывает информацию об открытых письмах в рассылке.
GET | https://api.snov.io/v1/get-emails-opened |
campaignId (обязательно) | Уникальный id рассылки, для которой вы хотите просмотреть открытия. |
<?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)
[ { "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": "" } ]
campaignId | Уникальный id рассылки. |
campaign | Название рассылки. |
prospectName | Полное имя получателя, открывшего письмо. |
emailSubject | Тема открытого письма. |
visitedAt | Точное время открытия письма. |
Этот метод возвращает информацию о всех получателях в рассылке, которые перешли по ссылке в одном или более письме.
GET | https://api.snov.io/v1/get-emails-clicked |
campaignId (обязательно) | Уникальный id рассылки, в которой вы хотите просмотреть переходы по ссылкам. |
<?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)
[ { "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": "" } ]
campaignId | Уникальный id рассылки. |
campaign | Название рассылки. |
prospectName | Полное имя получателя, перешедшего по ссылке в письме. |
prospectEmail | Email-адрес получателя. |
emailSubject | Тема письма, в котором был совершен переход по ссылке. |
emailBody | Текст письма. |
visitedAt | Точное время перехода по ссылке в письме. |
Этот метод показывает информацию об отправленных письмах в рамках указанной рассылки.
GET | https://api.snov.io/v1/emails-sent |
campaignId (обязательно) | Уникальный id рассылки, в которой вы хотите просмотреть отправленные письма. |
<?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)
[ { "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" } ]
sentDate | Точное время отправки письма. |
userName | Полное имя получателя рассылки. |
userEmail | Email-адрес получателя. |
campaign | Название рассылки. |
Этот метод предоставляет список всех рассылок пользователя.
GET | https://api.snov.io/v1/get-user-campaigns |
Для этого метода отсутствуют необходимые входящие параметры |
<?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)
[ { "id": 237945, "campaign": "Test", "hash": "6467f86496cbc8c69fbf827c1b1df770" }, { "id": 237943, "campaign": "Test", "hash": "c7e2f944bd655f74a4fced201469df29" } ]
id | Уникальный id рассылки пользователя. |
campaign | Название рассылки. |