Як використовувати API пошуку у базі даних

У цьому гайді ви дізнаєтеся, як знаходити контактів і компанії за допомогою API Пошуку у базі даних.

Методи API Пошуку у базі даних

• Пошук контактів
• Знайти email контакту
• Пошук компаній
• Додати контакти до списку

API Пошуку у базі даних — одна з кількох доступних категорій API для автоматизації роботи в Snov.io.

API пошуку у базі даних надає доступ до тієї самої бази контактів і компаній, що стоїть за Пошуком у базі даних у вебзастосунку.

Використовуйте його для пошуку контактів і компаній через API-запити.

Перевірка кількості доступних контактів безплатна — кредити витрачаються лише коли ви знаходите перевірену адресу та повний профіль. API повертає ті самі дані, що ви бачите у  вебзастосунку.

Методи API Пошуку у базі даних

Методи API Пошуку у базі даних за етапами робочого процесу:

Пошук контактів

Ці методи шукають у базі контактів Snov.io за вашими фільтрами.

Запустити пошук контактів

Надішліть фільтри, щоб запустити пошук контактів. Ви отримаєте task hash для отримання результатів на наступному кроці.

Обов'язкові параметри: щонайменше один фільтр — filters

Звужуйте пошук до контактів, що відповідають вашому ICP. Можна комбінувати фільтри на рівні контакту та компанії в одному запиті:

• Фільтри контакту: посада, рівень менеджменту, відділ, навички, локація, ім'я та прізвище
• Фільтри компанії: назва, локація, галузь, розмір, діапазон доходу, спеціалізації, рік заснування

Фільтри посад розпізнають поширені варіації — «CEO» також знаходить «Chief Executive Officer». Фільтри локацій зіставляються з верифікованим списком локацій Snov.io; якщо збігів немає — API повертає до 15 схожих варіантів замість порожнього результату.

Отримати результати пошуку контактів

Отримайте контактів, що відповідають вашим фільтрам.

Кожен контакт у відповіді містить посаду, локацію, галузь і дані компанії. Прізвище та URL-адресу профілю LinkedIn частково приховані до запуску пошуку email.

Обов'язкові параметри:
task_hash — task hash задачі з вашого пошукового запиту, в URL

Результати надходять з пагінацією — до 20 контактів на сторінку. За замовчуванням повертається сторінка 1; змініть номер сторінки, щоб отримати результати з наступних. Загальна кількість показує, скільки контактів і сторінок відповідають вашим фільтрам.

Знайти email контакту

Ці методи отримують email-адресу контакту, повне прізвище та повний URL профілю LinkedIn.

Запустити пошук email

Запитайте приховані контактні дані знайденого контакту: використайте URL email_and_hidden_info_reveal , щоб отримати email-адресу, повне прізвище та повний URL LinkedIn.

Обов'язкові параметри:
task_hash — task hash задачі контакту, в URL

Отримати результати пошуку email

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

Відповідь містить повне ім'я контакту, URL LinkedIn та email-адресу зі статусом (valid або unknown).

Обов'язкові параметри:
task_hash — task hash задачі з попереднього запиту, в URL

Пошук компаній

Ці методи шукають компанії у базі даних Snov.io. Використовуйте пошук компаній для формування цільового списку акаунтів перед пошуком людей усередині цих акаунтів.

Запустити пошук компаній

Надішліть фільтри, щоб запустити пошук компаній.

Ви отримаєте task hash для отримання результатів на наступному кроці. Фільтри охоплюють назву компанії, локацію, галузь, розмір, дохід, спеціалізації та рік заснування.

Обов'язкові параметри: щонайменше один фільтр — filters

Отримати результати пошуку компаній

Отримайте компанії, що відповідають вашим фільтрам.

Кожна компанія у відповіді містить домен, локацію, галузь, розмір, діапазон доходу та логотип.

Обов'язкові параметри::
task_hash — task hash задачі з вашого пошукового запиту, в URL

За кожен унікальний запит стягується 1 кредит — лише якщо результати містять щонайменше одну компанію.

Додати контактів до списку

Коли потрібні адреси знайдено — додайте цих контактів до списку Snov.io за допомогою цього методу. Потім запустіть кампанію аутрічу так само, як із контактами, доданими через застосунок.

Наступні кроки в API

Запускайте кампанії аутрічу

Будуйте та запускайте мультиканальні послідовності аутрічу для знайдених контактів. Детальніше — в API кампаній.

Вартість кредитів API пошуку у базі даних

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