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

LinkedIn Ad Library API

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

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

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

Какие данные LinkedIn Ad Library можно получить?

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

Идентификаторы объявления и рекламодателя

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

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

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

Публичные данные о показах

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

SocQ vs LinkedIn Campaign Manager

SocQ собирает публичные данные раскрытия из Ad Library. Campaign Manager — отдельный продукт LinkedIn для авторизованных рекламодателей, которые управляют своими кампаниями.

ВозможностьSocQLinkedIn Campaign Manager
Основное назначениеПоиск и нормализация публичных записей объявленийСоздание и управление авторизованными кампаниями
Входные данныеПоиск по компании или ключевому слову либо один точный URL страницы объявленияИдентификаторы авторизованного аккаунта и кампаний
АутентификацияAPI-ключ SocQАккаунт LinkedIn и рекламные разрешения
РезультатПубличные поля раскрытияПриватные настройки кампаний и отчетность

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

Оба эндпоинта используют асинхронный процесс SocQ: отправка, опрос и чтение; Search может вернуть несколько страниц, а Ad Details возвращает не более одной записи.

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

    Передайте компанию, ID компании или ключевое слово в Search либо один точный публичный URL страницы объявления Ad Library в Ad Details.

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

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

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

    Обрабатывайте data.results.items и переходите по next_cursor, пока has_more равно true; запрос данных объявления возвращает ноль или один элемент.

Поиск публичных объявлений LinkedIn

Пройдите аутентификацию с вашим API-ключом SocQ. Search по умолчанию возвращает 24 результата; Ad Details принимает один точный URL страницы объявления и не использует пагинацию.

curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"Microsoft","countries":["US"],"results_limit":24}'

# Or retrieve one known record:
# POST /v1/linkedin-ad-library/ad
# {"url":"https://www.linkedin.com/ad-library/detail/666281156"}
# Poll GET /v1/tasks/{task_id}

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

Поиск рекламы конкурентов

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

Анализ креативов

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

Публичные рекламные датасеты

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

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

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

  • Search требует хотя бы одно из полей company, keyword или company_id; при сочетании полей используется логика сопоставления источника.
  • countries принимает двухбуквенные коды, даты должны образовывать корректный диапазон, а results_limit должен быть кратен 24 — от 24 до 1 992.
  • Завершенный поиск может не содержать элементов или содержать повторяющиеся строки источника; недоступный URL страницы объявления тоже может не вернуть записи.
  • Поля рекламодателя, креатива, показа, числа показов, целевой ссылки, формата и медиа могут отсутствовать, и их нельзя интерпретировать как ноль.

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

Что можно передавать?

Search принимает название компании, ID компании, ключевое слово или поддерживаемое их сочетание. Ad Details принимает один точный публичный URL страницы объявления в LinkedIn Ad Library.

Возвращает ли этот API приватную аналитику кампаний?

Нет. Он возвращает доступные публичные данные раскрытия и не раскрывает расходы, клики, конверсии, правила таргетинга или данные аккаунта из Campaign Manager.

Сколько записей могут вернуть эндпоинты?

Search по умолчанию возвращает 24 записи и принимает значения, кратные 24, до 1 992. Ad Details возвращает ноль или одну запись.

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

Каждая возвращенная запись объявления стоит 0,5 кредита. Успешная задача без записей не оплачивается.

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

Reddit API

Получайте публичные публикации и комментарии Reddit по известным URL, просматривайте новые, лучшие или горячие публикации сабреддитов либо ищите обсуждения по ключевому слову и периоду публикации.

Pinterest API

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

Threads API

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

Bluesky API

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

Snapchat API

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

Twitch API

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