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.
| Возможность | SocQ | Meta 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. Выберите API и входные данные
Начните с ключевого слова, названия компании, числового ID страницы или публичного URL /ads/library — в зависимости от того, какая запись вам нужна.
2. Отправьте задачу и отслеживайте ее
Отправьте соответствующий POST-запрос, сохраните возвращенный task_id и опрашивайте /v1/tasks/{task_id}, пока обработка не завершится.
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 публикаций или одну страницу публикаций аккаунта с нормализованными полями идентичности, контента, медиа, меток времени и видимой вовлеченности.



