Огляд Metapi.io 2026: як працює парсер реклами Meta

Metapi.io є сервісом із керованим API для збору публічних оголошень із Meta Ad Library та повернення структурованих даних у JSON або CSV. Сервіс використовують для моніторингу креативів, рекламодавців і ринків без ручного копіювання карток із бібліотеки реклами Meta. У робочому процесі слід враховувати ліміти тарифу, неповноту публічних даних і правила автоматизованого збору інформації.

Головна перевага Metapi.io для маркетолога полягає в тому, що сервіс дає змогу регулярно шукати оголошення з тими самими фільтрами, отримувати структуровані дані та передавати їх до власної аналітичної системи. Завантаження зображень у цьому випадку має другорядне значення. Цим сервіс відрізняється від звичайного спай-сервісу для пошуку креативів, де користувач переважно переглядає готову базу через інтерфейс.

Огляд актуальний станом на жовтень 2026 року. Згідно з документацією Metapi.io, сервіс підтримує REST API, авторизацію через Bearer token, створення завдань за URL або параметрами пошуку, вебхуки та експорт результатів. Для команди, яка досліджує кілька країн, корисно відразу прив'язати збір до методики локального моніторингу ринку, інакше великий CSV-файл швидко перетворюється на невпорядкований масив оголошень.

Що таке Metapi.io і для яких завдань він підходить

Metapi.io підходить командам, яким потрібен регулярний потік даних із Meta Ad Library у машинному форматі. Типові користувачі сервісу: маркетингові агенції, продуктові аналітики, розробники SaaS і дослідники рекламних ринків. Разовий пошук десяти креативів простіше виконати вручну. Для моніторингу сотень рекламодавців доцільно використовувати API, чергу завдань і журнал результатів.

Основні сценарії виглядають так:

• моніторинг запусків конкретного рекламодавця за Page ID
• пошук оголошень за ключовими словами у вибраній країні
• збереження зображень, відео, текстів і CTA для аналізу креативної стратегії
• відстеження дати старту та завершення показу оголошення
• передача нових результатів у Slack, електронну пошту або власний API-ендпоінт через вебхук
• формування CSV для аналітика без ручного копіювання даних

Найкорисніші результати дає чітко сформульований запит: «знайти активні відеооголошення п'яти брендів у Німеччині за останні 30 днів». Запит «зібрати всю рекламу e-commerce» надто широкий. Чітку вибірку під час збору даних легше перевірити вручну, дедуплікувати та порівняти між рекламодавцями.

Як Metapi.io збирає та повертає дані реклами Meta

Сервіс приймає критерії пошуку, створює завдання та повертає масив рекламних об'єктів. Запит можна сформувати з параметрів або передати готовий URL Meta Ad Library. У другому варіанті Metapi.io читає фільтри з URL, а користувач окремо задає кількість потрібних результатів.

В описі API зазначено два основні способи пошуку: пошук за ключовим словом і пошук за ідентифікатором рекламодавця. Доступні країна, статус оголошення, тип реклами, медіаформат, дати та сортування.

Документація описує параметр count для завдання на основі URL; перед інтеграцією звірте його допустимий діапазон із чинною специфікацією, оскільки рекламні матеріали постачальника містять різні заяви про обсяг однієї вибірки. Це максимальна кількість запитаних записів, а не гарантія їх отримання.

Потік обробки складається з кількох етапів:

1. створіть акаунт і згенеруйте API-ключ у кабінеті
2. збережіть ключ у змінній середовища, а не в клієнтському коді
3. сформуйте URL бібліотеки або JSON із параметрами пошуку
4. надішліть POST-запит до API-ендпоінта для створення завдання
5. перевіряйте статус завдання до завершення або підключіть вебхук
6. отримайте результати у форматі JSON або підготуйте експорт у CSV
7. перевірте дублікати, пропуски та відповідність вибраній країні

Для першої інтеграції зручно підготувати тестовий запит без прив’язки до неперевіреного ендпоінта. Визначте Page ID рекламодавця, країну, статус оголошень і бажану кількість результатів. Передайте ці параметри відповідно до схеми з офіційної документації API, використовуючи ключ авторизації на сервері.

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

Після виконання завдання команда отримує дані в машинному форматі, придатному для подальшого аналізу.

Кожен запис може містити назву та ID сторінки, тексти оголошення, заголовки, описи, CTA, прямі URL медіа, країни показу, мови та дати показу. Доступність окремих полів залежить від категорії та регіону; перевірте їх на тестовій вибірці. Точні витрати, CTR, CPA та конверсії звичайних комерційних оголошень Meta публічно не розкриває, тому парсер не може чесно відновити ці показники з Ad Library.

Які функції Metapi.io корисні для рекламної аналітики

Найкориснішим Metapi.io є для регулярного моніторингу. Окремий запит показує стан реклами на момент збору, а повторні запити зі збереженням історії допомагають відстежувати появу креативів, тривалість показу та зміни рекламних повідомлень. Вебхуки дають змогу автоматизувати сповіщення, але конкретні події та умови доставки варто перевірити під час пілота.

Станом на дату огляду сервіс заявляє такі можливості:

• REST API з відповідями JSON і CSV
• пошук за ключовим словом або сторінкою рекламодавця
• фільтри країни, статусу, дат, типу реклами та медіа
• архів рекламних даних за понад два роки, про який повідомляє постачальник; фактичне охоплення потрібно перевірити на контрольній вибірці
• вебхуки для автоматичної доставки повідомлень на власний API-ендпоінт, причому типи подій потребують перевірки
• прямі посилання на доступні зображення та відео
• заявлену ціль доступності 99,9 відсотка, яка не є незалежно підтвердженою статистикою; у правилах сервісу постачальник водночас зазначає, що не гарантує безперервної роботи, тому договірні умови SLA слід уточнити окремо

Перевірити якість отриманих даних допоможе пілотне тестування, описане нижче.

Для регулярного моніторингу зберігайте дату запиту, застосовані фільтри й кількість отриманих записів. Це допоможе відрізнити зміни рекламної активності від збою збору. Це також створює основу для порівняння результатів у динаміці.

Скільки коштує Metapi.io у 2026 році

Станом на жовтень 2026 року на офіційній сторінці Metapi.io опубліковано п’ять тарифів із наведеними нижче цінами, місячними квотами та ставками за перевищення. Ліміти запитів за хвилину звірено з документацією API. Під час вибору плану враховуйте також добові обмеження, зазначені в документації. Постачальник може змінювати умови, тому перед оплатою перевірте тарифну сторінку та договір. Крім наведених планів, постачальник згадує Enterprise з індивідуальними умовами.

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

Приклад: агенція відстежує 20 брендів двічі на день і в середньому отримує 60 записів за одну перевірку. За умови незмінного обсягу кожної відповіді протягом 30 днів це 72 000 записів. Із запасом 20 відсотків плановий обсяг становитиме 86 400. Без запасу квоту Lite буде перевищено на 47 000 записів, тоді як у Pro залишиться 28 000; із запасом у Pro залишиться 13 600 записів. Це розрахунок споживання квоти, а не остаточної суми рахунку: для Lite слід також врахувати плату за перевищення.

Фактичні витрати залежать від того, як сервіс обліковує повторні записи та чи можна запитувати лише нові оголошення. Видалення дублікатів після отримання відповіді не обов’язково зменшує обсяг, зарахований до квоти. Під час пілота уточніть правила обліку повторних записів, порожніх відповідей і невдалих запитів.

Чим Metapi.io відрізняється від ручного пошуку та власного парсера

Metapi.io знімає з команди частину інфраструктурної роботи, але не замінює методологію дослідження. Ручний пошук кращий для швидкої якісної оцінки. Власний парсер дає найбільше можливостей для контролю, однак потребує інженера, проксі, моніторингу змін і регулярного обслуговування. Керований API займає середню позицію.

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

Під час оцінювання врахуйте й суміжний досвід парсингу Instagram: стабільність залежить не тільки від коду, а й від джерела, сесій, темпу запитів та змін інтерфейсу. Керований сервіс бере цю операційну частину на себе, але залежність від одного постачальника нікуди не зникає.

Практичний вибір залежить від частоти збору та наслідків можливої помилки. Якщо дані потрібні щодня, порахуйте витрати на підтримку за квартал і порівняйте їх із підпискою, а не лише з вартістю одного запуску.

Які ризики та обмеження потрібно перевірити до інтеграції

Головний ризик полягає в тому, що структурована відповідь виглядає точнішою, ніж джерело. Якщо Meta затримала індексацію оголошення, прибрала медіа або не публікує конкретний показник, API не створить відсутні дані. Тому звіт має розрізняти нульове значення, порожнє поле й технічну помилку.

Перед оплатою та інтеграцією перевірте такі пункти:

• відповідність збору чинним умовам Meta та законодавству потрібної юрисдикції
• повноту результатів на відомих сторінках рекламодавців
• частку дублікатів після повторних завдань
• доступність медіафайлів через кілька днів після експорту
• поведінку API при кодах 401, 402, 429, 500 і 503
• зберігання API-ключів і ротацію скомпрометованих токенів
• правила зберігання зібраних даних усередині компанії

У правилах повторних запитів передбачте різну обробку помилок. 401 вимагає перевірки ключа, 402 за документацією Metapi.io означає перевищення квоти, а 429 потребує паузи відповідно до Retry-After, якщо цей заголовок наявний. Його значення може бути кількістю секунд або HTTP-датою, після якої дозволено повторити запит.

Якщо його немає, застосовуйте поступове збільшення затримки з випадковим відхиленням. Для 500 і 503 зазвичай доречні повторні спроби з наростаючою затримкою та обмеженням їх кількості. Без такого поділу інтеграція або зупинятиметься через тимчасовий збій, або безконтрольно витрачатиме квоту.

Існує також аналітичне обмеження. Довга тривалість показу може бути сигналом стабільного креативу, але не доводить його прибутковість. Без даних про витрати на рекламу, CTR, CPA та конверсії команда бачить рекламну активність, а не фінансовий результат. Використовуйте ці дані для гіпотез, не для категоричних висновків про ROI конкурента.

Як перевірити Metapi.io перед підключенням до робочого процесу

Пілот Metapi.io має тривати щонайменше кілька днів і працювати на контрольному наборі. Мета тестування не в тому, щоб зібрати якомога більше записів. Потрібно зрозуміти, чи сервіс повертає достатньо повні, стабільні та придатні до аналізу дані для потрібних країн і категорій.

Проведіть тест послідовно:

1. виберіть п'ять рекламодавців із різною кількістю активних оголошень
2. зафіксуйте ручний контрольний зріз у Meta Ad Library
3. створіть однакові завдання за Page ID та країною
4. порівняйте кількість унікальних оголошень і доступних медіа
5. повторіть запити через 24 години
6. перевірте дедуплікацію за стабільним ID оголошення, попередньо звіривши назву й поведінку відповідного поля API
7. налаштуйте тестовий вебхук на окремий API-ендпоінт
8. розрахуйте вартість отримання одного нового корисного запису

Після пілота визначте критерії прийнятності результатів. Наприклад, частка записів без медіафайлів не перевищує 5 відсотків, повторний запит не створює понад 2 відсотки невиявлених дублікатів, а вебхук доставляється в межах узгодженого часу. Це приклади внутрішніх критеріїв, а не гарантії сервісу. Допустимі значення залежать від завдання.

Як Afina доповнює процес дослідження реклами

Metapi.io забезпечує отримання структурованих рекламних даних, але аналітику часто потрібно перевіряти вручну в різних клієнтських або регіональних середовищах. Тут виникає інша проблема: файли cookie, проксі, локальне сховище та цифровий відбиток браузера не повинні змішуватися між робочими контурами. Матеріал надано виключно в ознайомчих та освітніх цілях.

Afina можна використати як окремий браузерний шар для таких перевірок: кожен клієнт або досліджуваний регіон працює у власному профілі зі своїми файлами cookie, цифровим відбитком браузера та проксі. Це не підвищує точність даних Metapi.io, але допомагає розділити ручну перевірку, доступи та сесії команди й процес збору через API. Функції сервісів розмежовані: Metapi.io постачає записи, Afina розділяє браузерні середовища, а аналітична система рахує метрики.

Скачати