Ко всем API
Независимые публичные данные о прозрачности рекламы

Google Ad Library API

Находите публичных рекламодателей, собирайте креативы компании или получайте один известный креатив из Transparency Center по URL для исследований и проверки.

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

Используйте Advertiser Search для поиска кандидатов, Company Ads — для сбора ограниченных наборов креативов, а Ad Details — для получения одного точного публичного URL креатива.

Какие данные о прозрачности рекламы Google можно получить?

SocQ нормализует доступные публичные поля Transparency Center, сохраняя недоступные значения источника как null или пустые.

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

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

Креатив и целевые ссылки

Собирайте доступный текст, ссылки на рекламодателя, форматы, медиаматериалы и целевые страницы.

Публичный контекст показа

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

SocQ и продукты Google Ads

SocQ нормализует поддерживаемые публичные записи о прозрачности рекламы. Для авторизованной работы с аккаунтами и кампаниями по-прежнему подходят продукты Google Ads.

ВозможностьSocQПродукты Google Ads
Основное назначениеПоиск и нормализация публичных записей о прозрачности рекламыУправление авторизованными рекламными аккаунтами и кампаниями
Входные данныеЗапрос, идентификатор компании и фильтры или точный URL креативаДанные аккаунта, кампании или отчетности, специфичные для продукта
АутентификацияAPI-ключ SocQУчетные данные и авторизация Google для конкретного продукта
Формат ответаНормализованные публичные записи рекламодателей и объявленийИсходный ответ конкретного продукта

Как работают API Google Ad Library

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

  1. 1. Выберите эндпоинт

    Отправьте запрос в Advertiser Search, домен или ID рекламодателя — в Company Ads, а один URL креатива — в Ad Details.

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

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

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

    Обрабатывайте data.results.items; Company Ads соблюдает запрошенный лимит, а Ad Details возвращает не более одного элемента.

Сбор публичных объявлений одной компании

Пройдите аутентификацию с API-ключом SocQ и укажите домен компании или ID рекламодателя. Лимит результатов по умолчанию — 40.

curl -X POST "https://api.socq.ai/v1/google-ad-library/company-ads" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"lululemon.com","results_limit":40}'

# Also available:
# POST /v1/google-ad-library/advertiser-search
# POST /v1/google-ad-library/ad
# Poll GET /v1/tasks/{task_id}

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

Определение рекламодателей

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

Исследование креативов компании

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

Обогащение выбранных креативов

Дополняйте запись известного креатива полями рекламодателя, текста, медиа, целевой ссылки и показа.

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

Результаты зависят от текущей публичной видимости в источнике и не включают приватные данные аккаунтов Google Ads.

  • Advertiser Search требует один query и принимает необязательный регион; параметра results_limit у него нет.
  • Company Ads требует domain или advertiser_id и принимает results_limit, кратный 40, от 40 до 2 000.
  • Ad Details требует один URL adstransparency.google.com, путь которого содержит /creative/, и возвращает не более одного элемента.
  • Публичные записи могут быть неполными и не раскрывают приватные бюджеты, клики, конверсии, ставки, аудитории или окупаемость рекламных расходов.

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

С какого эндпоинта начать?

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

Можно ли фильтровать объявления компании?

Да. Необязательные параметры включают тему, регион, диапазон дат, площадку Google, формат и ограниченный results_limit.

Дают ли эти API доступ к приватной эффективности кампаний?

Нет. Они работают с публичными записями о прозрачности рекламы и не раскрывают приватную аналитику аккаунтов или кампаний.

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

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

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

Google Maps API

Находите публичные места, получайте нормализованные данные по известным URL Maps и собирайте публичные отзывы с привязанным к источнику контекстом места и автора.

Amazon API

Ищите публичные товары Amazon и собирайте нормализованные записи карточек товаров, бестселлеров, отзывов, профилей продавцов и витрин авторов с поддерживаемых маркетплейсов.

Apple App Store API

Собирайте публичные данные о приложениях Apple App Store, рейтинги категорий и отзывы по известным URL магазина в виде нормализованных записей приложений и отзывов.

SEO API

Запрашивайте органическую выдачу Google в реальном времени, сравнивайте спрос и сложность продвижения по ключевым словам, расширяйте исходные запросы, находите ключевые слова и страницы, которые обеспечивают сайту видимость в поиске, классифицируйте поисковый интент и собирайте результаты Google News, Google Images, Google Autocomplete, Bing и YouTube. Все эндпоинты используют один API-ключ SocQ, асинхронный процесс задач и нормализованный формат результатов.

Telegram API

Читайте открытые Telegram-каналы по ссылкам t.me: профили каналов с числом подписчиков, публикации с просмотрами и реакциями, отдельные публикации, комментарии из групп обсуждения, похожие каналы и поиск по всей истории.

Link in Bio API

Превращайте единственную ссылку из био автора в Instagram, TikTok или YouTube в структурированные данные: отображаемое имя, био, аватар, указанный контактный email, связанные профили в соцсетях и каждую кнопку страницы с заголовком и адресом.