linkedin-ad-library/
ad

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

LinkedIn Ad Library Ad API

Точный URL объявления
Публичное раскрытие рекламы
Поля прозрачности, допускающие null
0,5 кредита за результат
Готово
Готово

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

README

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

LinkedIn Ad Library Ad

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

Возможности LinkedIn Ad Library Ad API

  • Обработка точного URL объявленияПреобразует один URL на linkedin.com, путь которого содержит /ad-library/detail/, не более чем в одну нормализованную публичную запись объявления.
  • Контекст креатива и рекламодателяСохраняет доступные идентификатор объявления, текст, ссылку на рекламодателя, формат, целевую ссылку и медиа в стабильной структуре объявления SocQ.
  • Публичные сведения о показеВозвращает доступные даты первого и последнего показа, страны, места размещения и безопасно нормализованное скалярное значение показов, не восстанавливая закрытый таргетинг.
  • Безопасность ограниченных записейНедоступные значения рекламодателя, текста, целевой ссылки, показов или медиа остаются null, а не домысливаются, если источник их скрывает.

Параметры LinkedIn Ad Library Ad API

ПараметрыОбязательныйОписание
urlОбязательныйОбязательный публичный URL страницы объявления LinkedIn Ad Library. Схема должна быть http или https, хост должен заканчиваться на linkedin.com, а путь — содержать /ad-library/detail/.

Как использовать LinkedIn Ad Library Ad API

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

  1. Скопируйте один URL LinkedIn Ad Library со схемой http или https, путь которого содержит /ad-library/detail/.
  2. Отправьте url методом POST на /v1/linkedin-ad-library/ad и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items; операция получения деталей возвращает не более одной записи и не превращает недоступный URL в поиск.
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/ad-library/detail/666281156"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

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

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

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

  • Передавайте полный URL страницы объявления, а не просто ID объявления, страницу компании, URL поиска или список URL.
  • Отличайте успешную задачу без пригодного элемента от сбоя источника: ни то, ни другое не доказывает, что объявления никогда не было.
  • Сохраняйте поля, допускающие null: ограниченные или истекшие записи могут намеренно не содержать сведений о рекламодателе, превью, плательщике, тексте, медиа или показе.
  • Для поиска используйте LinkedIn Ad Library Search; эта операция обрабатывает только точный переданный URL объявления.

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

  • LinkedIn Ad Library Search API — Ищите публичную рекламу LinkedIn по компании, ID компании или ключевому слову с фильтрами по стране, датам и лимитом результатов.

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

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

LinkedIn Ad Library Ad API — FAQ

LinkedIn Ad Library Ad API — это программный интерфейс для получения одной публичной записи LinkedIn Ad Library по ее точному URL страницы объявления. Он возвращает нормализованные поля рекламодателя, креатива, показа, целевой ссылки, показов и медиа, если публичная запись их раскрывает.

Передайте один URL на linkedin.com со схемой http или https, путь которого содержит /ad-library/detail/. Отдельные ID, страницы компаний, URL поиска и списки URL не принимаются.

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

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

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