facebook-ad-library/
company-search

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

Facebook Ad Library Company Search API

Запрос по компании или странице
Кандидаты страниц рекламодателей
Показатели страницы и Instagram
0,5 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Facebook Ad Library Company Search

Кандидаты-компании в Facebook Ad Library — это страницы рекламодателей, которые определяются по ID страницы, названию, категории, стране, изображениям, признакам верификации и связанному аккаунту Instagram. Эти данные об идентичности и аудитории помогают точно определить рекламодателя, сравнивать одноименные страницы и осознанно выбирать страницу перед исследованием рекламы.

Возможности Facebook Ad Library Company Search API

  • Поиск по компании и названию страницыОтправьте один непустой запрос с названием компании, бренда или страницы и получите всех кандидатов страниц рекламодателей, найденных по этому запросу.
  • Идентификация и классификация страницВозвращает ID страниц, названия, производные публичные URL, категории, страны, типы сущностей, признаки верификации, изображения и признак удаленной страницы, если они доступны.
  • Видимые показатели страницы и InstagramСохраняет доступное число лайков в Facebook вместе со связанными именами пользователей Instagram, числом подписчиков и статусом верификации в нормализованных записях кандидатов.

Параметры Facebook Ad Library Company Search API

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

Как использовать Facebook Ad Library Company Search API

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

  1. Подготовьте один непустой запрос с названием компании, бренда или публичной страницы.
  2. Отправьте query методом POST на /v1/facebook-ad-library/company-search и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не вернет ошибку.
  4. Читайте data.results.items и запрашивайте next_cursor, пока has_more остается true.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Example Sports"}'

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

Сценарии использования Facebook Ad Library Company Search API

  • Определение ID страницы рекламодателя: Используйте ID, названия, URL, категории и страны кандидатов, чтобы выбрать идентификатор, нужный для запроса Company Ads в рамках страницы.
  • Сравнение одноименных и региональных страниц: Сравнивайте категории, страны, типы сущностей, изображения, признаки верификации и связанные аккаунты Instagram у рекламодателей с похожими названиями.
  • Проверяемые списки выбора рекламодателей: Храните данные страницы, видимые показатели аудитории, исходный запрос и время сбора за элементом выбора рекламодателя или исследовательским индексом.

Практические советы по Facebook Ad Library Company Search API

  • Передавайте только query: Company Search не принимает results_limit и фильтры объявлений по статусу, стране, медиафайлам или датам.
  • Если у нескольких кандидатов знакомое название, сравнивайте ID страницы, URL, категорию, страну, изображение, верификацию и связанный аккаунт Instagram, а не выбирайте первый результат.
  • Следуйте next_cursor, пока has_more не станет false, чтобы пагинация результатов задачи не скрыла сохраненного кандидата.
  • Считайте данные аккаунта Instagram, число подписчиков, признаки верификации, изображения и признак удаленной страницы необязательными показателями и обрабатывайте отсутствующие поля, не отбрасывая кандидата.

Помимо Facebook Ad Library Company Search API, используйте эти API, когда нужен другой тип публичных данных Facebook Ad Library.

  • Facebook Ad Library Search API — Ищите публичную рекламу по ключевому слову с настройкой совпадения, типа рекламы, страны, статуса, медиа, сортировки, дат и лимита результатов.
  • Facebook Ad Library Company Ads API — Собирайте публичную рекламу одного рекламодателя по Page ID: креатив, показ, рынок, медиа, CTA и видимые сигналы.
  • Facebook Ad Library Ad API — Собирайте одно публичное объявление из Ad Library по его URL: креатив, рекламодатель, медиа, показ, CTA и видимые сигналы.

Другие платформы

Объединяйте данные Facebook Ad Library с публичными данными других поддерживаемых соцсетей.

Facebook Ad Library Company Search API — FAQ

Facebook Ad Library Company Search API находит кандидатов публичных страниц рекламодателей по непустому запросу с названием компании или страницы. Он возвращает ID страниц, поля идентификации и классификации, изображения, видимые метрики аудитории и связанные данные Instagram.

Эндпоинт принимает одну обязательную непустую строку query. Он не принимает results_limit и фильтры объявлений по стране, статусу, медиафайлам, языку, сортировке или датам.

Нет. Он возвращает кандидатов страниц рекламодателей и числовой ID страницы, который используется в Company Ads, а не записи о креативах или показах.

Сравните ID страницы, название, URL, категорию, страну, тип сущности, изображение, признак верификации и связанный аккаунт Instagram. Одно лишь знакомое название не доказывает, что кандидат — нужный рекламодатель.

Поиск компаний не принимает results_limit и сохраняет все уникальные доступные ID страниц, найденные по запросу. При этом завершенная задача всё равно может разбивать сохраненные записи на страницы с помощью next_cursor и has_more.

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

Каждый возвращенный кандидат компании стоит 0,5 кредита SocQ. Оценка запроса строится на 10 кандидатах, а за пустой набор результатов при текущих настройках тарификации плата не взимается.