linkedin-ad-library/
search

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

LinkedIn Ad Library Search API

Поиск по компании и ключевому слову
Пагинация по 24 записи
Публичные сведения о рекламе
0,5 кредита за результат
Готово
Готово

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

README

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

LinkedIn Ad Library Search

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

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

  • Три способа поискаИщите по названию компании, ключевому слову, точному ID компании LinkedIn или нескольким из этих полей в одном запросе; хотя бы одно обязательно.
  • Фильтры по стране и датеСужайте публичный индекс двухбуквенными кодами стран и необязательным включительным диапазоном дат показа в формате YYYY-MM-DD.
  • Нормализованные записи публичной рекламыВозвращает стабильный идентификатор объявления, ссылку на рекламодателя, текст креатива, URL страницы объявления, даты, рынки, формат, целевую ссылку, показы и медиа, если они раскрыты.
  • Ограниченная пагинация по токенамСобирайте от 24 до 1 992 записей с шагом 24: SocQ переходит по новым токенам пагинации источника, пока не достигнет лимита или последней пригодной страницы.
  • От поиска к деталямПередайте возвращенный URL /ad-library/detail/ в LinkedIn Ad Library Ad, если для одной найденной записи нужны доступные детальные данные.

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

ПараметрыОбязательныйОписание
companyОбязательный (хотя бы один)Название компании или рекламодателя. Обязательно хотя бы одно из полей company, keyword или company_id.
keywordОбязательный (хотя бы один)Текст для поиска среди публичной рекламы. Правила сопоставления определяет публичный источник.
company_idОбязательный (хотя бы один)Точный ID компании LinkedIn, используемый для поиска.
countriesНеобязательныйНеобязательный список двухбуквенных буквенных кодов стран, желательно в верхнем регистре, например US и CA.
start_dateНеобязательныйНеобязательное начало фильтра по дате публичного показа в формате YYYY-MM-DD.
end_dateНеобязательныйНеобязательный конец фильтра по дате публичного показа в формате YYYY-MM-DD; не может быть раньше start_date.
results_limitНеобязательныйМаксимальное число запрашиваемых записей. По умолчанию 24, допускаются значения, кратные 24, от 24 до 1 992.

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

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

  1. Укажите company, keyword или company_id; сочетайте их, только если вам действительно нужно более узкое совпадение по правилам источника.
  2. При необходимости добавьте двухбуквенные коды countries, корректный диапазон дат и results_limit, кратный 24.
  3. Отправьте запрос методом POST на /v1/linkedin-ad-library/search и сохраните возвращенный task_id.
  4. Опрашивайте /v1/tasks/{task_id}, затем читайте data.results.items и переходите по next_cursor, пока has_more равно true.
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}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

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

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

  • Начинайте с одного поля поиска, а company, keyword и company_id сочетайте, только если полезен более узкий набор результатов по правилам источника.
  • Используйте коды стран в верхнем регистре для единообразия сохраненных входных данных, хотя текущий валидатор принимает любой регистр.
  • Выбирайте results_limit с шагом 24 записи и считайте его потолком сбора, а не обещанием, что для каждого места найдется совпадение.
  • Сохраняйте запрос, фильтры и время collected_at при сравнении запусков, потому что публичная доступность и сохраненные записи меняются.
  • Считайте отсутствующие значения рекламодателя, дат, страны, показов, целевой ссылки, формата или медиа нераскрытыми данными, а не нулем.

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

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

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

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

LinkedIn Ad Library Search API — FAQ

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

Укажите хотя бы одно из полей company, keyword или company_id. Можно передать несколько сразу, но точное сопоставление и пересечение определяет публичный поиск источника.

Эндпоинт принимает список двухбуквенных кодов countries, а также необязательные значения start_date и end_date. Публичной опции сортировки нет.

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

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

Источник возвращает до 24 объявлений на страницу. SocQ переходит по каждому новому токену пагинации, пока не достигнет results_limit, последней страницы, пустой страницы, отсутствующего или повторяющегося токена.

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