Site icon База знань Snov.io

Як доповнити наявні дані через Snov.io API

У цій статті описано, як надсилати дані для доповнення та отримувати розширені B2B-дані у відповідь через API Snov.io.

Як використовувати Snovio API для збагачення даних:

- Автоматизуйте процес лідогенерації та верифікуйте бізнес-адреси

- Розширте свої наявні дані додатковими

- Покращте свою програму за допомогою наших даних

- Інтегруйте інструменти Snov.io у свої наявні робочі процеси

Як працює доповнення даних:

Надішліть дані, які у вас є, до Snovio через запит API. Ми зіставимо вашу інформацію з нашою базою даних або знайдемо її для вас. Ви отримаєте розширені дані.

Цей процес автоматично доповнює вашу наявну інформацію новими даними. Використання API робить це масштабованим, незалежно від того, чи потрібно вам доповнити 10 записів чи 10 000.

Які типи доповнення даних доступні в Snov.io?

--> Домени з назв компаній

--> Профілі LinkedIn з посилань

--> Email Verifier: статус верифікації email-адреси

--> Email Finder: email-адреси з імени контакта

Пошук доменних імен за назвами компаній

Використовуючи збагачення доменів, знайдіть домен (сайт) компанії, вказавши її точну офіційну назву.

Як це працює:

1) Надішліть назви компаній до API.

2) Отримайте відповідні домени компаній у відповідь.

Щоб знайти адреси та потенційних клієнтів за доменами, використовуйте API «Пошук за доменом».

Крок 1. Надішліть свої дані (вкажіть назви компаній)


URL запиту: https://api.snov.io/v2/company-domain-by-name/start

Тип запиту: POST


Введіть назву компанії, для якої ви хочете отримати домен, у параметр “names[]”.

Ви можете додати до 10 компаній на запит. Додайте кожну назву компанії в окремому параметрі.

names[]: company_1

names[]: company_2

Щоб автоматично отримувати результати, додайте параметр "webhook_url" до вашої цільової URL-адреси, куди Snov.io надсилатиме збагачені дані.

Ви також можете автоматично отримувати інформацію про інші події у своєму акаунті. Повний список вебхуків дивіться тут.

Використання вебхука необов'язкове. Якщо ви його пропустите, ви можете отримати результати за допомогою окремого запиту API.

Відповідь надасть "task_hash": унікальний ідентифікатор для вашого запиту. Вам знадобиться цей ідентифікатор, щоб отримати результати через подальший запит API.

Крок 2. Отримання результатів (отримання доменів компанії)

Існує два способи отримання доповнених даних:


Тип запиту: GET

URL: https://api.snov.io/v2/company-domain-by-name/result?task_hash={hash_from_1}


У параметрі "task_hash" додайте унікальний ідентифікатор з вашого попереднього запиту, куди ви надсилали дані.

Для кожної компанії, яку ви запитували, Snov.io API поверне такі поля даних:

Для отримання додаткової інформації зверніться до прикладів запитів та відповідей у ​​нашій документації API.

Отримання інформації профілю LinkedIn з URL-адрес

Використовуючи збагачення профілю LinkedIn, отримайте інформацію про потенційного клієнта, надавши посилання на його профіль.

Як це працює:

Крок 1. Надішліть свої дані (надайте URL-адреси LinkedIn)


Тип запиту: POST

URL: https://api.snov.io/v2/li-profiles-by-urls/start


У параметрі "urls[]" додайте URL-адреси LinkedIn, для яких ви хочете отримати інформацію. Ви можете додати до 10 URL-адрес на один запит. Кожна URL-адреса має бути в окремому параметрі.

urls[]: LinkedIn profile_1

urls[]: LinkedIn profile_2

urls[]: LinkedIn profile_3

Щоб отримувати результати автоматично, додайте параметр "webhook_url" до вашої цільової URL-адреси, куди Snov.io надсилатиме доповнені дані. Використання вебхука необов'язкове. Якщо ви його пропустите, ви можете отримати результати за допомогою окремого запиту API.

Відповідь на цей запит надасть "task_hash": унікальний ідентифікатор для вашого запиту. Вам знадобиться цей ідентифікатор, щоб отримати результати під час надсилання подальшого запиту API.

Крок 2. Отримання результатів (отримання інформації про профіль потенційного клієнта)

Існує два способи отримання доповнених даних:


Тип запиту: GET

URL: https://api.snov.io/v2/li-profiles-by-urls/result?task_hash={hash_from_1}


У параметрі "task_hash" додайте унікальний ідентифікатор з вашого попереднього запиту "надіслати дані".

Для кожної URL-адреси, яку ви надіслали для збагачення, Snov.io API повертатиме такі дані: ім'я, прізвище, посади, галузь, локація, країна, назва компанії та домен компанії.

Для отримання додаткової інформації зверніться до прикладів запитів та відповідей у ​​нашій документації API.

Перевірка статусу адреси електронної пошти

За допомогою API Email Verifier ви можете перевірити, чи ваші email-адреси валідні. Наша верифікація підтверджує, що ваш список розсилки не має ризиків для доставки та готовий до використання в кампаніях.

Як це використовувати:

Крок 1. Надішліть свої дані (надайте email-адреси для перевірки)


Тип запиту: POST

URL: https://api.snov.io/v2/email-verification/start


У параметрі "emails[]" введіть адреси, статус яких потрібно перевірити.

Ви можете перевірити до 10 адрес за один запит. Додайте кожну адресу в окремому параметрі.

emails[]: email address_1

emails[]: email address_2

emails[]: email address_3

Щоб автоматично отримувати результати перевірки, додайте параметр "webhook_url" разом із цільовою URL-адресою, куди Snov.io їх надсилатиме. Використання вебхука необов'язкове. Якщо ви його пропустите, ви можете отримати результати за допомогою окремого запиту API.

Відповідь надасть "task_hash": унікальний ідентифікатор для вашого запиту. Вам знадобиться цей ідентифікатор, щоб отримати результати під час надсилання подальшого запиту API.

Крок 2. Отримання результатів (отримання статусу)

Існує два способи отримання доповнених даних:


Тип запиту: GET

URL: https://api.snov.io/v2/email-verification/result?task_hash={hash_from_1}'


У параметрі "task_hash" додайте унікальний ідентифікатор, отриманий з вашого попереднього запиту, куди ви надсилали дані.

Для кожної адреси, яку ви додали для перевірки, Snov.io перевірить та поверне один із трьох статусів:

Для адрес зі статусом "unknown" ми надаємо детальну причину, визначену під час перевірки. Це може бути одна з наступних причин:

Banned: Високий ризик доставлення – адресу не вдалося перевірити зі 100 % точністю.

Catchall: Ризик репутації відправника – поштовий сервер використовує політику "catchall", що унеможливлює підтвердження існування адреси.

Connection error: Високий ризик баунсу через технічні проблеми на стороні одержувача.

Greylisted: Поштовий сервер використовує фільтри сірого списку, що ускладнює верифікацію пошти.

Hidden by owner: Власник адреси або компанія, яка володіє доменом, надіслали запит на його видалення з результатів Snov.io.

Повний список доповнених полів дивіться в документації API.

Знайти адресу пошти за іменем та доменом

За допомогою API Email Finder ви можете знайти верифіковані адреси для бізнесу, вказавши ім'я потенційного клієнта та домен його компанії.

Як це працює:

Крок 1. Надішліть свої дані (вкажіть ім'я та домен)


Тип запиту: POST

URL: https://api.snov.io/v2/emails-by-domain-by-name/start


У параметрі "rows" (рядки) надайте інформацію про потенційного клієнта: ім'я, прізвище та домен.

API Email Finder підтримує масовий пошук. Ви можете доповнити дані до 10 потенційних клієнтів в одному запиті API. Ми знайдемо та перевіримо email-адресу потенційного клієнта. Багатоетапна перевірка гарантує, що ви отримуватимете точні бізнес-адреси.

Для кожного потенційного клієнта у вашому запиті включіть масив даних з такими полями:

У полях "first_name" та "last_name" вкажіть ім'я та прізвище потенційного клієнта.

У полі "domain" (домен) вкажіть доменне ім'я компанії, в якій працює потенційний клієнт.

"first_name": імʼя контакта
"last_name": прізвище контакта
"domain": сайт компанії

Щоб автоматично отримувати результати пошуку, додайте параметр "webhook_url" до вашої цільової URL-адреси, куди Snov.io їх надсилатиме. Використання вебхука необов'язкове. Якщо ви його пропустите, ви можете отримати результати за допомогою окремого запиту API.

У відповіді буде надано "task_hash": унікальний ідентифікатор для вашого запиту. Вам знадобиться цей ідентифікатор, щоб отримати результати під час надсилання подальшого запиту API.

Крок 2. Отримання результатів (отримання верифікованої адреси)

Є два способи отримати результати:


Тип запиту: GET

URL: https://api.snov.io/v2/emails-by-domain-by-name/start/result?task_hash={hash_from_1}


У параметрі "task_hash" для цього запиту додайте унікальний ідентифікатор, який ви отримали з попереднього запиту, куди ви надсилали дані.

Для кожного потенційного клієнта, якого ви додали до запиту, Snov.io поверне такі дані:

Для отримання додаткової інформації зверніться до нашої документації API.

Вартість доповнення даних через API в кредитах

У таблиці нижче ми надамо детальну інформацію про те, як Snov.io стягує кредити з балансу вашого облікового запису під час використання запитів на доповнення даних, пошуку через API та верифікації адрес пошти.

Кредити списуються лише за успішні запити API. Якщо результати не знайдено та у відповіді не надано дані, кредити з вашого облікового запису не стягуватимуться.
Доповнення Запит API Кредити
Назви доменів з компаній https://api.snov.io/v2/company-domain-by-name/start 1 кредит за кожну компанію, для якої Snovio надав адресу домену. 
Профіль за URL https://api.snov.io/v2/li-profiles-by-urls/start 1 кредит за кожну URL-адресу профілю LinkedIn, для якої Snovio надав інформацію про потенційного клієнта. 
Email Verification https://api.snov.io/v2/email-verification/start 1 кредит за кожну адресу електронної пошти, перевірену в запиті, незалежно від результатів перевірки (чи є статус valid, unknown або not_valid). 
Email Finder https://api.snov.io/v2/emails-by-domain-by-name/start 1 кредит за кожного потенційного клієнта в запиті, для якого ми знайшли valid (зелену) або unknown (жовту) адресу пошти. Якщо email-адреса not_valid, ми не стягуємо за неї кредити.
Exit mobile version