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

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

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

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

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

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

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

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

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

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

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

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

Як це працює:

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

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

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

---

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

Тип запиту: POST

---

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

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

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

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

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

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

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

• Вебхук: Якщо ви додали вебхук до попереднього запиту, ми надішлемо результати туди, коли вони будуть готові.
• Окремий запит API: Використовуйте наступний запит.

---

Тип запиту: GET

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

---

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

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

• "name": Початкова назва компанії, яку ви вказали
• "domain": Доменна адреса компанії

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

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

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

Як це працює:

• Надайте URL-адресу профілю LinkedIn API.
• Отримайте повну інформацію про потенційного клієнта, включно з посадою та іншою інформацією.

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

---

Тип запиту: POST

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

---

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

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

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

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

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

• Вебхук: Якщо ви додали вебхук до попереднього запиту, ми надішлемо результати туди, коли вони будуть готові.
• Окремий запит API: Використовуйте наступний запит.

---

Тип запиту: 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 адрес за один запит. Додайте кожну адресу в окремому параметрі.

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

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

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

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

• Вебхук: Якщо ви додали вебхук до попереднього запиту, ми надішлемо результати туди, коли вони будуть готові.
• Запит API: Використовуйте наступний запит.

---

Тип запиту: GET

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

---

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

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

• valid: Адреса існує та може отримувати повідомлення
• not_valid: Адреса не існує або не може отримувати повідомлення
• unknown (Неможливо перевірити): Адресу не вдалося перевірити зі 100 % впевненістю, але, ймовірно, вона все ще валідна.

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

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

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

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

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

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

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

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

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

Як це працює:

• Надішліть ім'я, прізвище та доменне ім'я потенційного клієнта в API.
• Отримайте у відповідь адресу та статус верифікації.

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

---

Тип запиту: POST

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

---

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

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

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

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

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

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

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

• Вебхук: Якщо ви додали вебхук до попереднього запиту, ми надішлемо результати туди після завершення пошуку.
• Окремий запит API: Використайте наступний запит.

---

Тип запиту: GET

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

---

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

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

• Адреса пошти
• Статус верифікації (valid, not_valid або unknown)
• Результати додаткових перевірок, які або підтверджують дійсність, або пояснюють, чому статус невідомий

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

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

У таблиці нижче ми надамо детальну інформацію про те, як Snov.io стягує кредити з балансу вашого облікового запису під час використання запитів на доповнення даних, пошуку через 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, ми не стягуємо за неї кредити.