Ко всем API
Независимые данные Facebook Ad Library

Facebook Ad Library API

Ищите публичные объявления Facebook по ключевому слову, находите страницы рекламодателей, собирайте объявления по ID страницы или получайте одно известное объявление с нормализованными полями креатива, медиа, показа, CTA и целевой ссылки.

Доступные API Facebook Ad Library

Используйте Search для поиска объявлений по ключевому слову, Company Search — чтобы найти ID страницы, Company Ads — чтобы собрать объявления этой страницы, а Ad Details — чтобы получить одно известное публичное объявление.

Какие данные Facebook Ad Library можно получить?

SocQ возвращает нормализованные записи публичных объявлений и рекламодателей для исследования креативов, мониторинга конкурентов, анализа кампаний и рекламных датасетов.

Результаты поиска объявлений

Ищите публичные объявления по ключевому слову или точной фразе с необязательными фильтрами по стране, статусу, медиа, типу объявления, дате, сортировке и лимиту результатов.

Записи страниц рекламодателей

Находите ID страниц, названия, URL, категории, страны, изображения, значения верификации, видимые отметки «Нравится» страницы и связанные данные Instagram.

Объявления конкретной страницы

Собирайте ограниченный набор уникальных публичных объявлений по одному числовому ID страницы рекламодателя с необязательными фильтрами по показу и медиа.

Текст и медиа креатива

Получайте доступные заголовки объявлений, основной текст, описания ссылок, форматы отображения и ссылки на публичные изображения или видео без дублей.

Показ и рыночный контекст

Сохраняйте доступные время начала и окончания, статус активности, площадки размещения, страны, охват, валюту, расходы и сигналы отметок «Нравится» страницы.

Призывы к действию и целевые ссылки

Получайте видимый текст и тип CTA, публичные целевые URL, URL в Ad Library, данные рекламодателя и метки времени сбора, если они доступны.

SocQ vs Meta Ad Library API

SocQ предоставляет готовые процессы сбора публичных объявлений. Ad Library API от Meta — официальный вариант прямого доступа к архиву прозрачности рекламы Meta.

ВозможностьSocQMeta Ad Library API
Основное назначениеПоиск публичных объявлений и сбор данных о рекламодателях или объявленияхЗапросы к официальному архиву прозрачности рекламы Meta
АутентификацияAPI-ключ SocQ; OAuth клиента в Facebook не нуженПриложение Meta, токен доступа и доступ к Ad Library
Входные данныеКлючевое слово, название компании, ID страницы или публичный URL Ad LibraryПараметры запроса к официальному архиву и идентификаторы Meta
Создание и управление объявлениямиНе поддерживаетсяНе поддерживается; используйте Meta Marketing API
Формат ответаНормализованные записи SocQИсходные объекты Meta Graph API

Как работает Facebook Ad Library API

Все четыре API используют одинаковый процесс асинхронной задачи и постраничного получения результатов.

  1. 1. Выберите API и входные данные

    Начните с ключевого слова, названия компании, числового ID страницы или публичного URL /ads/library — в зависимости от того, какая запись вам нужна.

  2. 2. Отправьте задачу и отслеживайте ее

    Отправьте соответствующий POST-запрос, сохраните возвращенный task_id и опрашивайте /v1/tasks/{task_id}, пока обработка не завершится.

  3. 3. Читайте нормализованные результаты

    Обрабатывайте data.results.items и переходите по next_cursor, пока has_more равно true.

Поиск публичных объявлений по ключевому слову

Пройдите аутентификацию с вашим API-ключом SocQ и отправьте ключевое слово в эндпоинт Search. Остальные API Ad Library используют тот же процесс задач.

curl -X POST "https://api.socq.ai/v1/facebook-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","results_limit":100,"status":"ACTIVE"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Типичные сценарии использования Facebook Ad Library API

Мониторинг рекламы конкурентов

Отслеживайте публичные объявления выбранных страниц рекламодателей и сравнивайте креативы, медиа, статус показа, рынки, CTA и целевые ссылки во времени.

Исследование креативов и сообщений

Ищите по названиям продуктов, категорий или брендов, чтобы изучать тексты публичных объявлений, форматы, медиа, призывы к действию и целевые страницы.

Поиск рекламодателей

Сопоставляйте названия компаний или брендов с публичными ID страниц и полями идентичности, прежде чем собирать целевой набор объявлений конкретной страницы.

Рекламные датасеты

Сохраняйте нормализованные ID объявлений, записи рекламодателей, поля креатива, контекст показа, исходные URL и метки времени collected_at для анализа.

Ограничения и политика публичных данных

Результаты Facebook Ad Library — это публичные записи на определенный момент. Эти API не управляют рекламными аккаунтами и не предоставляют приватные данные об эффективности кампаний.

  • Search требует один непустой query; results_limit по умолчанию равен 100 и принимает целые числа от 20 до 2 000.
  • Company Search принимает один запрос с названием компании или страницы, не принимает results_limit и может вернуть несколько страниц-кандидатов с похожими названиями.
  • Company Ads требует один числовой ID страницы; results_limit принимает значения от 20 до 2 000, а фильтры могут уменьшить число возвращенных записей.
  • Ad Details принимает один публичный URL facebook.com/ads/library с числовым id и возвращает не более одной нормализованной записи объявления.
  • Завершенная задача может не вернуть записей, если объявление, страница или отфильтрованный набор результатов недоступны в публичном источнике.
  • Поля охвата, расходов, валюты, медиа, дат, CTA, целевой ссылки и рекламодателя могут отсутствовать, и их нельзя интерпретировать как ноль.

Частые вопросы о Facebook Ad Library API

Что такое Facebook Ad Library API?

Facebook Ad Library API — это набор эндпоинтов SocQ для поиска публичных объявлений, поиска страниц рекламодателей, сбора объявлений конкретной страницы и получения данных об известных публичных объявлениях.

Какой API Facebook Ad Library выбрать?

Используйте Search для поиска по ключевому слову, Company Search — чтобы найти ID страницы, Company Ads — чтобы собрать объявления по этому ID, а Ad Details — для одного известного публичного URL Ad Library.

Что можно искать и фильтровать?

Search принимает ключевое слово или точную фразу и необязательные фильтры по стране, статусу, медиа, типу объявления, дате, сортировке и лимиту результатов. Company Ads поддерживает фильтры по показу и медиа для конкретной страницы.

Какие публичные данные объявлений возвращаются?

Результаты могут содержать идентификаторы объявления и рекламодателя, текст креатива, изображения или видео, даты показа, статус активности, площадки размещения, страны, CTA, целевую ссылку и видимые публичные сигналы.

Почему завершенный запрос может не вернуть результатов?

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

Это то же самое, что API социальных данных Facebook или Marketplace?

Нет. Эндпоинты Facebook Ad Library отделены от API SocQ для страниц, публикаций и комментариев Facebook, а также от API объявлений Facebook Marketplace.

Сколько стоят результаты Facebook Ad Library?

Объявления из Search, кандидаты из Company Search и записи Company Ads стоят 0,5 кредита за каждый возвращенный результат. Ad Details стоит 0,6 кредита за каждый возвращенный результат, а пустые результаты не оплачиваются.

Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.

X API

Собирайте публичные профили, списки подписчиков и подписок, посты, ответы, цитаты, пользователей, сделавших ретвит, результаты поиска и текущие тренды. Используйте единообразные результаты для исследований и мониторинга.

LinkedIn API

Получайте публичные данные профилей, компаний, публикаций и вакансий LinkedIn по известным URL с нормализованными полями идентичности, карьеры, компании, контента, вовлеченности и вакансии.

Reddit API

Получайте публичные публикации и комментарии Reddit по известным URL, просматривайте новые, лучшие или горячие публикации сабреддитов либо ищите обсуждения по ключевому слову и периоду публикации.

Pinterest API

Получайте публичные данные профилей Pinterest, разбирайте известные пины, собирайте пины выбранных профилей или ищите по ключевым словам, чтобы исследовать авторов, контент и визуальные тренды.

Threads API

Получайте публичные профили Threads, разбирайте известные публикации или собирайте публикации выбранных профилей с нормализованными полями идентификации, контента, медиа, вовлеченности и временных меток.

Bluesky API

Получайте публичные профили Bluesky, данные по известным URL публикаций или одну страницу публикаций аккаунта с нормализованными полями идентичности, контента, медиа, меток времени и видимой вовлеченности.