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, отслеживайте асинхронную задачу и прочитайте нормализованную запись, если она доступна.
- Скопируйте один URL LinkedIn Ad Library со схемой http или https, путь которого содержит /ad-library/detail/.
- Отправьте url методом POST на /v1/linkedin-ad-library/ad и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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 объявления.
Связанные API
Помимо LinkedIn Ad Library Ad API, используйте эти API, когда нужен другой тип публичных данных LinkedIn Ad Library.
- LinkedIn Ad Library Search API — Ищите публичную рекламу LinkedIn по компании, ID компании или ключевому слову с фильтрами по стране, датам и лимитом результатов.