google-ad-library/
advertiser-search

Находите варианты публичных рекламодателей в Google Ads Transparency Center по запросу и необязательному региону: нормализованные идентификаторы, сайт, логотип, регион и доступное число объявлений.

Google Ad Library Advertiser Search API

Варианты рекламодателей
Необязательный регион
Стабильные поля идентичности
0,5 кредита за результат
Готово
Готово

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

README

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

Google Ad Library Advertiser Search

По поисковому запросу с названием бренда, организации или сайта Google Ads Transparency Center может показать несколько записей рекламодателей, включая региональные или схожие по названию организации. Проверка их ID, названий, сайтов, логотипов, регионов и доступного числа объявлений помогает выбрать нужную публичную запись рекламодателя перед сбором его креативов.

Возможности Google Ad Library Advertiser Search API

  • Поиск рекламодателей по названиюИщите по одному непустому названию бренда, организации, рекламодателя или сайта и получайте нормализованные варианты рекламодателей, а не рекламные креативы.
  • Необязательный региональный контекстПередайте регион, например US, чтобы задать контекст поиска у источника; регион при этом не смешивается с географией показа рекламы.
  • Поля идентичности вариантовСравнивайте публичный ID рекламодателя, название, URL, сайт, логотип, регион и доступное число объявлений по данным источника без домысленного обогащения.
  • Полное сохранение одного ответаСохраняет всех пригодных рекламодателей из одного ответа поиска у источника; лимит результатов на стороне клиента и цикл пагинации у провайдера не применяются.

Параметры Google Ad Library Advertiser Search API

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

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

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

  1. Выберите конкретное название рекламодателя, бренда, организации или сайта; при необходимости добавьте регион, например US.
  2. Отправьте query и необязательный region методом POST на /v1/google-ad-library/advertiser-search и сохраните task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items и проверяйте идентичность вариантов не только по сходству названий, прежде чем выбрать ID рекламодателя.
curl -X POST "https://api.socq.ai/v1/google-ad-library/advertiser-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Nike","region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Review data.results.items as advertiser candidates

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

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

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

  • Используйте конкретное юридическое название, бренд или похожий на домен запрос: широкие формулировки дают неоднозначные варианты, а правила сопоставления не гарантируются.
  • Считайте region контекстом поиска, а не доказательством того, что вся реклама рекламодателя показывалась в этом регионе.
  • Проверяйте варианты по ID, названию, сайту, региону и публичной странице рекламодателя, прежде чем объединять записи или собирать креативы.
  • Не передавайте results_limit: эта операция сохраняет массив пригодных рекламодателей из одного ответа источника и не выполняет пагинацию источника.

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

  • Google Ad Library Ad API — Получайте один известный публичный креатив из Transparency Center по URL: рекламодатель, текст, медиа, показ, регион, формат, целевая страница и показы.
  • Google Ad Library Company Ads API — Собирайте публичные креативы из Transparency Center по домену компании или ID рекламодателя с фильтрами по теме, региону, датам, площадке, формату и лимитом результатов.

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

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

Google Ad Library Advertiser Search API — FAQ

Google Ad Library Advertiser Search API — это программный интерфейс для поиска вариантов публичных рекламодателей в Google Ads Transparency Center по запросу и необязательному региону. Он возвращает нормализованные идентификаторы рекламодателя и зависящие от источника поля сайта, логотипа, региона и числа объявлений, а не рекламные креативы.

Только варианты рекламодателей. Чтобы получить список публичных креативов, используйте проверенный ID рекламодателя или домен в отдельной операции company-ads.

Регион — это географический контекст, передаваемый в поиск рекламодателей. Он может помочь сузить список вариантов, но не является гарантированным точным фильтром и не доказывает географию показа рекламы.

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

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