TikTok Ad Library API
Находите поддерживаемые публичные рекламные записи TikTok по запросу или превращайте известный URL объявления в нормализованные поля для исследования, проверки и архивирования.
Доступные API TikTok Ad Library
Используйте Search, чтобы находить публичные рекламные записи по рекламодателю или ключевому слову, и Ad Details, чтобы получить данные по одному известному подходящему URL публичного объявления.
Какие публичные данные о рекламе можно получить?
Возвращаемые поля отражают публичную информацию, которая сейчас доступна для каждой поддерживаемой записи; недоступные значения источника остаются null или пустыми.
Идентификация объявления и рекламодателя
Собирайте публичные ID объявлений, доступные URL записей, названия рекламодателей, ссылки на рекламодателей и стабильные типы ресурсов.
Креатив и целевая страница
Изучайте доступный рекламный текст, формат, ссылки на медиа и публичные URL целевых страниц.
Видимый контекст показа
Читайте поддерживаемые даты показа, время публикации, страны, платформы, аудиторию и сведения о показах, если они раскрыты.
Контекст сбора
Сохраняйте нормализованные поля источника и сбора для очередей проверки, каталогов и исследовательских датасетов.
SocQ и рекламные продукты TikTok
SocQ обеспечивает сбор поддерживаемых публичных записей прозрачности только на чтение. Собственные продукты TikTok служат другим целям — от доступа к публичной библиотеке до авторизованного управления кампаниями.
| Возможность | SocQ | Рекламные продукты TikTok |
|---|---|---|
| Основное назначение | Поиск и нормализация поддерживаемых публичных рекламных записей | Публичная прозрачность или авторизованные операции с кампаниями — в зависимости от продукта |
| Входные данные | Один рекламодатель или ключевое слово либо один известный URL объявления | Настройки зависят от соответствующего раздела TikTok |
| Приватные данные кампаний | Недоступны | Требуются соответствующий аккаунт, продукт, одобрение и разрешения |
| Действия | Сбор публичных данных только на чтение | Ads Manager поддерживает авторизованные операции с кампаниями |
| Формат ответа | Стабильные рекламные записи SocQ | Нативные представления или ответы конкретного продукта |
Как работают API TikTok Ad Library
Оба эндпоинта используют асинхронный жизненный цикл: отправка, опрос и чтение; Search может собирать несколько страниц источника, а Ad Details возвращает не более одной записи.
1. Выберите эндпоинт
Отправьте одного рекламодателя или ключевое слово в Search либо один подходящий URL публичного объявления TikTok в Ad Details.
2. Опрашивайте задачу
Используйте возвращенный task_id с /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.
3. Читайте нормализованные записи
Обрабатывайте data.results.items и курсор результатов задачи, если он есть; запрос данных объявления возвращает ноль или одно объявление.
Пройдите аутентификацию с API-ключом SocQ. Search по умолчанию возвращает 12 результатов; у Ad Details нет пагинации и results_limit.
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Anysphere","results_limit":12}'
# Or resolve one known ad URL:
# POST /v1/tiktok-ad-library/ad
# {"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}
# Poll GET /v1/tasks/{task_id}Типичные сценарии использования TikTok Ad Library API
Мониторинг брендов
Регулярно формируйте наборы доступных публичных объявлений известного рекламодателя для проверки.
Анализ креативов
Получайте данные выбранных объявлений и изучайте поддерживаемые публичные поля текста, рекламодателя, формата, медиа и целевой страницы.
Архивирование для прозрачности
Сохраняйте нормализованные публичные рекламные записи с датами показа и контекстом сбора.
Обогащение исследований
Используйте результаты поиска, чтобы находить записи, а затем превращайте известные URL публичных объявлений в стабильные поля с подробными данными.
Ограничения и политика публичных данных
Публичные рекламные записи зависят от видимости в источнике, допустимости, географической доступности, задержки публикации, срока хранения и полей, которые показывает соответствующий раздел TikTok.
- Отсутствие в поиске не доказывает, что рекламодатель никогда не запускал рекламу, а недоступные URL могут не дать результата с данными объявления.
- Search не предоставляет фильтров по стране, дате, разделу, языку, отрасли, цели, обогащению и сортировке.
- Публичные даты, аудитория и показы — это не приватная отчетность о расходах, конверсиях, атрибуции или окупаемости рекламы (ROAS).
- Ссылки на медиа могут быть временными или контролироваться источником, а все поля, зависящие от источника, могут быть null или пустыми.
Частые вопросы о TikTok Ad Library API
Является ли SocQ аналогом TikTok Ads Manager?
Нет. SocQ ищет и нормализует поддерживаемые публичные записи прозрачности; он не управляет аккаунтами, кампаниями, бюджетами, таргетингом или креативами.
Что можно отправить?
Search принимает одно название рекламодателя или ключевое слово. Ad Details принимает один подходящий известный URL публичного объявления TikTok.
Содержит ли каждый результат полные данные объявления?
Нет. Search обычно возвращает сводки, запрос данных объявления может не вернуть записи, а все поля, зависящие от источника, могут быть null или пустыми.
Сколько стоит использование?
Каждая возвращенная запись стоит 0,5 кредита SocQ без базовой платы; Search по умолчанию возвращает 12 результатов, а Ad Details — не более одного.
Объединяйте данные разных платформ для более полной бизнес-аналитики
Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.
YouTube API
Собирайте поддерживаемые публичные профили каналов YouTube, данные о видео, видео каналов, комментарии, Shorts, результаты поиска по ключевым словам и хештегам и доступные расшифровки в едином нормализованном асинхронном процессе.
Facebook API
Собирайте публичные профили страниц Facebook, публикации, публикации в группах, комментарии, мероприятия по ключевому слову и доступные расшифровки видео с нормализованными полями идентичности, контента, источника, формата, места, медиа, реакций, посещаемости и вовлеченности.
X API
Собирайте публичные профили, списки подписчиков и подписок, посты, ответы, цитаты, пользователей, сделавших ретвит, результаты поиска и текущие тренды. Используйте единообразные результаты для исследований и мониторинга.
LinkedIn API
Получайте публичные данные профилей, компаний, публикаций и вакансий LinkedIn по известным URL с нормализованными полями идентичности, карьеры, компании, контента, вовлеченности и вакансии.
Reddit API
Получайте публичные публикации и комментарии Reddit по известным URL, просматривайте новые, лучшие или горячие публикации сабреддитов либо ищите обсуждения по ключевому слову и периоду публикации.
Pinterest API
Получайте публичные данные профилей Pinterest, разбирайте известные пины, собирайте пины выбранных профилей или ищите по ключевым словам, чтобы исследовать авторов, контент и визуальные тренды.

