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
Выберите хотя бы одно поле поиска, добавьте только те фильтры, которые определяют вашу выборку, и читайте страницы завершенной асинхронной задачи.
- Укажите company, keyword или company_id; сочетайте их, только если вам действительно нужно более узкое совпадение по правилам источника.
- При необходимости добавьте двухбуквенные коды countries, корректный диапазон дат и results_limit, кратный 24.
- Отправьте запрос методом POST на /v1/linkedin-ad-library/search и сохраните возвращенный task_id.
- Опрашивайте /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 при сравнении запусков, потому что публичная доступность и сохраненные записи меняются.
- Считайте отсутствующие значения рекламодателя, дат, страны, показов, целевой ссылки, формата или медиа нераскрытыми данными, а не нулем.
Связанные API
Помимо LinkedIn Ad Library Search API, используйте эти API, когда нужен другой тип публичных данных LinkedIn Ad Library.
- LinkedIn Ad Library Ad API — Получайте одну известную публичную запись LinkedIn Ad Library по точному URL с нормализованными полями рекламодателя, креатива, показа, целевой страницы, показов и медиа.