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 для авторизованных рекламодателей, которые управляют своими кампаниями.
| Возможность | SocQ | LinkedIn Campaign Manager |
|---|---|---|
| Основное назначение | Поиск и нормализация публичных записей объявлений | Создание и управление авторизованными кампаниями |
| Входные данные | Поиск по компании или ключевому слову либо один точный URL страницы объявления | Идентификаторы авторизованного аккаунта и кампаний |
| Аутентификация | API-ключ SocQ | Аккаунт LinkedIn и рекламные разрешения |
| Результат | Публичные поля раскрытия | Приватные настройки кампаний и отчетность |
Как работают API LinkedIn Ad Library
Оба эндпоинта используют асинхронный процесс SocQ: отправка, опрос и чтение; Search может вернуть несколько страниц, а Ad Details возвращает не более одной записи.
1. Выберите эндпоинт
Передайте компанию, ID компании или ключевое слово в Search либо один точный публичный URL страницы объявления Ad Library в Ad Details.
2. Отправьте задачу и отслеживайте ее
Отправьте POST-запрос, сохраните task_id и опрашивайте /v1/tasks/{task_id}, пока обработка не завершится.
3. Читайте нормализованные записи
Обрабатывайте data.results.items и переходите по next_cursor, пока has_more равно true; запрос данных объявления возвращает ноль или один элемент.
Пройдите аутентификацию с вашим 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 в нормализованный профиль, собирайте его публичные видео или получайте отдельный клип вместе со скачиваемым видео для исследования авторов, обогащения каталогов, сравнения и мониторинга снимков.

