Як користуватися інструментами Snov.io через API

Основні інструменти Snov.io доступні через REST API. Знаходьте контакти, збагачуйте їхні дані, верифікуйте email-адреси, запускайте кампанії аутрічу та відстежуйте результати — все через API.

Snov.io API

Нижче методи, доступні в кожній категорії API:

API пошуку за доменом

API збагачення даних

Email Finder API

Email Verifier API

API керування контактами

API email-акаунтів

API прогріву email

API мультиканальних кампаній

API контенту кампаній

API аналітики та звітності

Вебхуки

Як отримати токен доступу API

• Надішліть ID користувача API та ключ API у тілі запиту — у відповідь отримаєте токен доступу
• Токен доступу дійсний 1 годину (3600 секунд)
• Включайте токен у заголовок автентифікації кожного запиту

API Пошуку за доменом

Знаходьте інформацію про компанії, профілі контактів та email-адреси за доменом. У цьому API методи POST запускають пошук і повертають task_hash, а GET отримує результати.

Повні деталі методів API — у документації API.

Метод	Кінцева точка	Призначення
POST	https://api.snov.io/v2/domain-search/start	Запит інформації про компанію за доменом
GET	https://api.snov.io/v2/domain-search/result/{task_hash}	Отримати результати інформації про компанію
POST	https://api.snov.io/v2/domain-search/prospects/start	Пошук контактів за доменом і фільтрами посад
GET	https://api.snov.io/v2/domain-search/prospects/result/{task_hash}	Отримати результати пошуку контактів
POST	https://api.snov.io/v2/domain-search/domain-emails/start	Пошук email-адрес за доменом
GET	https://api.snov.io/v2/domain-search/domain-emails/result/{task_hash}	Отримати результати email-адрес домену
POST	https://api.snov.io/v2/domain-search/generic-contacts/start	Пошук загальних або рольових email-адрес
GET	https://api.snov.io/v2/domain-search/generic-contacts/result/{task_hash}	Отримання загальних контактів

API Збагачення даних

Розширюйте наявні дані додатковими B2B-даними з бази Snov.io.

Повні деталі методів API — у документації API.

Метод	Кінцева точка	Призначення
POST	https://api.snov.io/v2/company-domain-by-name/start	Збагатити домен за назвою компанії
POST	https://api.snov.io/v2/emails-by-domain-by-name/start	Збагатити email-адресу за іменем і доменом контакту
POST	https://api.snov.io/v2/li-profiles-by-urls/start	Збагатити профіль особи за URL LinkedIn
GET	https://api.snov.io/v1/get-profile-by-email	Збагатити профіль особи за email-адресою

Email Finder API

Отримуйте повні профілі контактів із посадами та верифікованими email-адресами за іменем і доменом або назвою компанії.

Повні деталі методів API — у документації API.

Метод	Кінцева точка	Призначення
POST	/v2/emails-by-domain-by-name/start	Знайти email-адреси за іменем і доменом (масово: до 10 за запит)
GET	/v2/emails-by-domain-by-name/result	Отримати знайдені email-адреси
POST	/v2/company-domain-by-name/start	Знайти домен за назвою компанії (масово: до 10 за запит)
GET	/v2/company-domain-by-name/result	Отримати домени компаній

Email Verifier API

Перевіряйте доставлюваність email багатокроковою верифікацією. Повертає статус valid, not_valid або unknown з детальними причинами. Перевіряйте зовнішні списки або інтегруйте верифікацію для перевірки email при реєстрації.

Повні деталі методів API — у документації API.

Метод	Кінцева точка	Призначення
POST	https://api.snov.io/v2/email-verification/start	Надіслати email-адреси на верифікацію (до 10 за запит)
GET	https://api.snov.io/v2/email-verification/result	Отримати результати верифікації

API керування контактами

Керуйте контактами у вашому акаунті. Автоматизуйте рутинні завдання: створення списків і організацію контактів за сегментами.

Повні деталі методів API — у документації API.

Метод	Кінцева точка	Призначення
POST	https://api.snov.io/v1/add-prospect-to-list	Додати контакт до списку
POST	https://api.snov.io/v1/lists	Створити новий список контактів
GET	https://api.snov.io/v1/prospect-list	Переглянути контакти в списку

API email-акаунтів

Керуйте email-акаунтами відправників. Підключайте, налаштовуйте та перевіряйте статус акаунтів.

Повні деталі методів API — у документації API.

Метод	Кінцева точка	Призначення
POST	https://api.snov.io/v2/sender-accounts/emails	Додати новий email-акаунт
PATCH	https://api.snov.io/v2/sender-accounts/emails/{id}	Оновити налаштування email-акаунту
GET	https://api.snov.io/v2/sender-accounts/check-sender-status	Список усіх акаунтів відправників
GET	https://api.snov.io/v2/sender-accounts/emails	Перевірити статус підключення акаунту

API прогріву email

Запускайте прогрів акаунтів відправників перед аутрічем для захисту доставлюваності та покращення репутації відправника.

Повні деталі методів API — у документації API.

Метод	Кінцева точка	Призначення
POST	https://api.snov.io/v2/warm-up	Створити кампанію прогріву
PATCH	https://api.snov.io/v2/warm-up/{id}	Оновити налаштування прогріву
GET	https://api.snov.io/v2/warm-up	Список кампаній прогріву
GET	https://api.snov.io/v2/warm-up/statistics/{id}	Отримати денну статистику прогріву

API мультиканальних кампаній

Керуйте повним процесом аутрічу — створюйте, налаштовуйте, запускайте та відстежуйте кампанії.

Повні деталі методів API — у документації API.

Метод	Кінцева точка	Призначення
POST	https://api.snov.io/ v2/campaigns/create	Створити нову кампанію
GET	https://api.snov.io/ v2/campaigns/{campaign_id}	Отримати деталі кампанії
PATCH	https://api.snov.io/ v2/campaigns/{campaign_id}	Оновити налаштування кампанії
POST	https://api.snov.io/ v2/campaigns/{campaign_id}/action	Змінити статус кампанії (запустити / призупинити / відновити / завершити / архівувати)
DELETE	https://api.snov.io/ v2/campaigns/{campaign_id}	Видалити кампанію
GET	https://api.snov.io/ v2/campaigns/schedules	Отримати розклади відправлення, додані в застосунку
GET	https://api.snov.io/ v2/blacklists	Отримати списки контактів-винятків

API вмісту кампаній

Керуйте вмістом email-кроків (темами та тілом) у межах послідовностей кампаній.

Повні деталі методів API — у документації API.

Метод	Кінцева точка	Призначення
POST	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/create	Створити/оновити вміст імейлу
GET	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/{content_id}	Отримати вміст імейлу
PATCH	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/{content_id}	Оновити вміст імейлу
DELETE	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/{content_id}	Видалити вміст імейлу

API аналітики та звітності

Отримуйте дані про залученість і результати кампаній по email і LinkedIn-каналах.

Повні деталі методів API — у документації API.

Метод	Кінцева точка	Призначення
GET	https://api.snov.io/ v2/statistics/campaign-analytics	Агреговані метрики кампаній за застосованими фільтрами
GET	https://api.snov.io/ v2/campaigns/[campaign_id]/progress	Прогрес завершення кампанії
GET	https://api.snov.io/ v2/campaigns/[campaign_id]/all-replies	Дані відповідей кампанії (email + LinkedIn)
GET	https://api.snov.io/ v1/get-emails-replies	Відповіді на кампанію (лише email)
GET	https://api.snov.io/ v1/get-emails-opened	Дані відкриттів імейлів
GET	https://api.snov.io/ v1/get-emails-clicked	Дані кліків на посилання
GET	https://api.snov.io/ v1/emails-sent	Журнал надісланих імейлів
GET	https://api.snov.io/ v1/get-user-campaigns	Список усіх кампаній

API вебхуків

Налаштовуйте автоматизації, що реагують на залученість контактів і активність кампаній у реальному часі. Вебхуки можуть надсилати дані активності email і LinkedIn-кампаній на URL кінцевої точки (endpoint). Це включає відповіді, автовідповіді, відкриття імейлів, кліки, завершення послідовності тощо. Перегляньте повний список вебхуків.