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
Отправьте один запрос с названием компании или страницы, отслеживайте асинхронную задачу и изучите нормализованных кандидатов страниц рекламодателей.
- Подготовьте один непустой запрос с названием компании, бренда или публичной страницы.
- Отправьте query методом POST на /v1/facebook-ad-library/company-search и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не вернет ошибку.
- Читайте 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, число подписчиков, признаки верификации, изображения и признак удаленной страницы необязательными показателями и обрабатывайте отсутствующие поля, не отбрасывая кандидата.
Связанные API
Помимо 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 и видимые сигналы.