У цифровому маркетингу, розробці продуктів і аналітиці скрапінг реклами часто використовують для розвідки реклами конкурентів та аналізу ринку. Зберегти кілька креативів з Meta Ad Library вручну нескладно, але щойно доводиться працювати з великими обсягами даних, такий підхід швидко стає непрактичним.
Створити власний скрапер Facebook Ad Library теж не так просто. 🥊 Meta активно ускладнює автоматичний збір даних: блокує IP-адреси після частих запитів, оновлює антибот-системи й регулярно змінює верстку сторінок. Через це підтримка власного скрапера й постійна заміна проксі можуть забирати чимало часу, ресурсів розробки й грошей.
Якщо вам потрібно збирати з Meta великі обсяги даних, практичнішим варіантом може стати спеціалізований інструмент, як-от Metapi.io. Платформа вивантажує рекламу через API у форматі JSON або CSV, зокрема тексти оголошень, прямі посилання на зображення й відео та дати показу.
У цьому огляді ми докладно розглянемо Metapi.io: основні можливості, кабінет, запуск першого завдання зі скрапінгу й доступні тарифи.
Типові складнощі самостійного скрапінгу реклами Facebook
Щоб збирати дані з Meta Ad Library, розробники зазвичай використовують офіційний API, готові скрапери на сторонніх платформах або власний скрапер реклами Facebook. На практиці кожен варіант має серйозні обмеження:
📌 Обмеження офіційного API Meta. Meta надає власний Ad Library API, але він розрахований насамперед на політичну рекламу й рекламу на соціальні теми. До того ж результати обмежені 25 записами на сторінку, тож зібрати великі масиви реклами через офіційний API складно.
📌 Скрипти часто ламаються. Facebook постійно ускладнює скрапінг, додаючи перевірки на ботів і змінюючи код сторінок. Часті запити можуть викликати помилку 429 і блокування IP. Власні скрапери можуть раптово перестати коректно збирати дані, тож розробникам доводиться оновлювати код щоразу, коли платформа щось змінює.
📌 Сторонні рішення, як-от Apify, можуть працювати нестабільно. Готові скрапери на платформах на кшталт Apify на великих обсягах стають дорогими: у середньому близько 2,40 $ за 1 000 рядків. Водночас приблизно третина запитів може завершуватися невдачею через технічні проблеми. Такі інструменти також можуть повертати дублікати або знаходити лише 5-10 оголошень, навіть коли на сторінці рекламодавця в Ad Library активні десятки креативів.
📌 Висока вартість розробки. Створення надійного скрапера реклами Meta з нуля може коштувати від 10 000 $ до 50 000 $. Навіть після запуску проєкт потребує постійних вкладень у нові проксі, усунення збоїв і час розробників, щоб програма працювала після кожного оновлення систем Meta.
Як працює Metapi.io і які дані він збирає
Metapi.io працює через стандартний REST API і слугує альтернативою Facebook Ad Library API для команд, яким потрібно більше гнучкості, ніж дає офіційний ендпоінт. Ви надсилаєте запит із потрібними фільтрами, а платформа повертає дані з Meta Ad Library у форматі JSON або як готовий до завантаження файл CSV.
Параметри пошуку
API підтримує такі фільтри:
- Ключові слова. Пошук конкретних фраз у текстах і заголовках оголошень.
- Сторінка рекламодавця. Збір реклами з конкретної фан-сторінки за її назвою або Page ID.
- GEO. Фільтр оголошень за країнами, де їх показують.
- Формат медіа. Фільтр результатів за статичними зображеннями чи відеокреативами.
- Статус оголошення й період показу. Пошук активних або неактивних оголошень у заданому діапазоні дат.
Що входить у вивантаження
Для кожного знайденого оголошення платформа може зібрати:
- Дані сторінки: назву фан-сторінки, Page ID і пряме посилання на сторінку Facebook.
- Текст оголошення: основний текст, заголовки, описи й текст кнопки CTA.
- Медіа: прямі посилання для завантаження зображень в оригінальній якості та відеофайлів у HD чи SD.
- Дати показу: першу й останню дату, коли креатив показувався.
- Дані про аудиторію: статистику показів за статтю, віком і країною.
Основні можливості платформи
- Висока пропускна здатність. Платформа обробляє понад 1 мільйон запитів на день з аптаймом 99,9%. Під час збору даних користувачам не доводиться мати справу з капчею, банами IP чи обмеженнями частоти запитів.
- Понад 2 роки історичних даних про рекламу. Facebook поступово прибирає неактивні оголошення зі стандартної видачі Ad Library. Metapi зберігає історичні дані понад два роки, тож можна знайти креативи, які давно перестали показуватися й більше недоступні через звичайний пошук в Ad Library.
- Вебхуки. Metapi може автоматично надсилати дані з затримкою менш ніж одна секунда. Достатньо вказати URL вашого сервера, сайту чи бота. Щойно з’являється нове оголошення з потрібними ключовими словами або з потрібної фан-сторінки, Metapi може одразу надіслати дані у вашу базу даних, на пошту чи в робочий простір Slack.
- Вивантаження в JSON і CSV. Metapi.io підтримує обидва формати. Відповіді в JSON зручні для інтеграції платформи з власним ПЗ і скриптами, а вивантаження в CSV дає змогу завантажити зібрані оголошення як звичайну таблицю.
Огляд кабінету й запуск першого завдання
Після реєстрації ви потрапляєте на головну сторінку кабінету. Меню ліворуч дає доступ до консолі й розділу API Docs. Унизу видно ваш профіль і поточний ліміт записів, а також розділи Usage, Billing і Settings.
Запуск скрапінгу через форму
Збір реклами налаштовується на вкладці Input. Запустити завдання можна двома способами: через візуальну форму або надіславши запит у JSON.
Щоб скористатися візуальною формою, відкрийте вкладку Form:
- Вставте URL з Meta Ad Library з потрібними фільтрами в поле Facebook Ad Library URL і натисніть Parse & Add.
- У полі Result count (per URL) вкажіть, скільки оголошень потрібно зібрати. Платформа підтримує від 1 до 50 000 креативів на один URL.
- Якщо потрібні додаткові фільтри, відкрийте розділ Advanced Parameters.
Коли всі поля налаштовано, натисніть Start Run, і платформа почне збирати дані.
Запуск завдання через JSON
Для збору реклами у великих обсягах перейдіть у режим JSON. Додайте потрібні URL з Facebook Ad Library у поле urls і задайте максимальну кількість креативів для вивантаження параметром count.
Відстеження завдань і вивантаження реклами
Стежити за завданнями й завантажувати готові результати можна на вкладці Runs.
Для зручності завдання можна фільтрувати за статусом:
- All: усі запуски;
- Running: завдання, які зараз обробляються;
- Succeeded: успішно завершені завдання;
- Failed: завдання, що завершилися помилкою;
- Timed Out: завдання, зупинені після досягнення ліміту часу;
- Aborted: завдання, скасовані вручну.
Готові файли із зібраними оголошеннями також можна завантажити прямо з цього розділу.
Статистика використання й витрата записів
Уся аналітика щодо скрапінгу й використання записів доступна в розділі Usage.
Блок Records used угорі показує залишок записів і дату скидання ліміту. Поруч видно основні показники акаунта:
- Total requests: загальна кількість надісланих запитів;
- This period: кількість запитів за поточний розрахунковий період;
- Succeeded і Failed: лічильники успішних і невдалих завдань;
- Records scraped: фактична кількість зібраних оголошень;
- Total cost: загальна сума списань за вибраний період.
Під цими показниками розміщено графіки активності за останні 30 або 90 днів, статистику витрат, використання за окремими API-ключами та список частих пошукових запитів.
Повний звіт можна завантажити у файлі CSV кнопкою Export CSV у правому верхньому куті.
Створення API-ключів і налаштування вебхуків
Щоб підключити Metapi до власних скриптів чи ПЗ, відкрийте розділ ⚙️ Settings.
Ключі доступу до API створюються в блоці API Keys. Введіть назву токена в поле Key name, наприклад назву конкретного сайту чи скрипту, і натисніть + Create Key. Новий ключ одразу з’явиться у списку.
Нижче розміщено розділ Webhooks. Він потрібен, щоб надсилати сповіщення, коли завдання зі скрапінгу реклами завершилося успішно або з помилкою.
Стандартного поля для введення URL вебхука в кабінеті немає. Вебхуки налаштовуються безпосередньо через API. Щоб підключити вебхук, надішліть POST-запит на /v1/webhooks. Після цього підключений URL з’явиться в кабінеті.
Методи GET і DELETE використовуються, щоб переглянути або видалити наявні вебхуки. Докладні параметри інтеграції описано в розділі API Docs.
Тарифи
Поточна підписка й статистика використання відображаються в розділі 💳 Billing.
Угорі видно активний тариф, кількість виконаних запитів і використаних записів. Нижче Metapi пропонує кілька тарифів під різні обсяги даних:
- Free: 3 000 записів на місяць, ліміт 120 запитів на хвилину й 1 000 запитів на день;
- Lite: 29 $ на місяць за 25 000 записів, понад ліміт 1,00 $ за 1 000 записів;
- Pro: 79 $ на місяць за 100 000 записів, понад ліміт 0,80 $ за 1 000 записів;
- Business: 149 $ на місяць за 500 000 записів, понад ліміт 0,30 $ за 1 000 записів;
- Scale: 299 $ на місяць за 2 000 000 записів, понад ліміт 0,15 $ за 1 000 записів;
- Enterprise: індивідуальний тариф від 10 мільйонів записів з окремим SLA і виділеною підтримкою.
Часті запитання
Що таке скрапер Facebook Ad Library?
Скрапер Facebook Ad Library - це інструмент, який автоматично збирає дані з бібліотеки реклами Meta (тексти оголошень, зображення, відео й дати показу) без ручного пошуку, обмежень частоти запитів і антибот-перевірок платформи.
Чи законно скрапити Facebook Ad Library?
Meta Ad Library - це публічний інструмент, який Meta надає задля прозорості, і дані в ньому загальнодоступні. Збір цих публічних даних структурованими запитами через спеціалізований скрапер, як-от Metapi.io, зазвичай вважається легітимним, але користувачам варто ознайомитися з умовами використання Meta та нормами своєї юрисдикції.
Чим Metapi.io відрізняється від офіційного Ad Library API від Meta?
Офіційний API від Meta охоплює лише політичну рекламу й рекламу на соціальні теми та повертає лише 25 записів на сторінку. Metapi.io працює як альтернатива Facebook Ad Library API: підтримує будь-які категорії реклами, повертає до 50 000 креативів на один URL і містить історичні дані за два роки.
Які дані можна вивантажити з Metapi.io?
Дані сторінки, повний текст оголошення, прямі посилання на медіа, дати показу й статистику аудиторії за статтю, віком і країною у форматі JSON або CSV.
Чи можна використовувати Metapi.io для розвідки реклами конкурентів?
Так. Фільтри за сторінкою рекламодавця, ключовим словом, географією й статусом показу роблять його практичним інструментом для розвідки реклами конкурентів і дослідження кампаній, зокрема тих оголошень, які вже не показуються.
Чи є в Metapi.io безкоштовний тариф?
Так: 3 000 записів на місяць, ліміт 120 запитів на хвилину, банківська картка не потрібна.
Чи може Metapi.io надсилати сповіщення про нові оголошення в реальному часі?
Так, через вебхуки: дані про нове оголошення надходять на ваш сервер, у базу даних чи робочий простір Slack менш ніж за секунду після появи відповідного оголошення.
Висновок
Самостійний скрапінг Facebook Ad Library може забирати багато часу й коштів. Через часті зміни верстки та блокування IP власні скрипти потребують постійної підтримки, а це додаткові години розробників і регулярні витрати на проксі та іншу інфраструктуру.
Metapi.io позбавляє потреби будувати й підтримувати таку інфраструктуру з нуля. Платформа надає структуровані дані про рекламу з текстами, прямими посиланнями на креативи й параметрами аудиторії, тож це практичний інструмент для дослідження реклами конкурентів. Архів за понад два роки також дає змогу вивчати кампанії конкурентів, які давно зупинилися й уже зникли зі стандартної видачі Facebook Ad Library.
Платформа підійде маркетинговим агенціям, продуктовим командам і аналітикам, яким потрібен стабільний потік даних про рекламу без значних витрат часу на технічне налаштування й підтримку скрапера.
Metapi.io також пропонує безкоштовний тариф на 3 000 записів на місяць без прив’язки картки, тож платформу можна протестувати, перш ніж переходити на платну підписку.
