TikTok Creative Center Top Ads
Top Ads в TikTok Creative Center — это отобранная подборка объявлений, которые хорошо работают в TikTok, и у каждого указаны подпись, отрасль, цель кампании, CTR, лайки и видео. Сравнение этих объявлений показывает, какие хуки, форматы и предложения стабильно выигрывают в категории, поэтому они подходят для креативных исследований, наблюдения за конкурентами и рекламных брифов.
Возможности TikTok Creative Center Top Ads API
- Собственный список топовой рекламы Creative CenterРезультаты берутся из объявлений, которые Creative Center относит к самым эффективным, и упорядочены по релевантности TikTok или по лайкам.
- CTR, лайки и контекст кампании для каждого объявленияКаждое объявление содержит ctr и likes, а также отрасль и цель в том виде, в каком их размечает Creative Center.
- Видео, а не только цифрыmedia возвращает URL видео объявления с миниатюрой, шириной, высотой и длительностью, а text содержит подпись.
- Ключевое слово, период и объемquery сужает выборку по ключевому слову, time_range задает период 7, 30 или 180 дней, а results_limit возвращает до 300 объявлений за запрос.
Параметры TikTok Creative Center Top Ads API
| Параметры | Обязательный | Описание |
|---|---|---|
query | Необязательный | Необязательное ключевое слово для фильтрации объявлений, например категория товаров. |
time_range | Необязательный | Глубина периода: 7d, 30d (по умолчанию) или 180d. |
sort_by | Необязательный | relevance — собственный порядок TikTok (по умолчанию), likes — сначала объявления с наибольшим числом лайков. |
results_limit | Необязательный | Сколько объявлений вернуть: от 1 до 300. По умолчанию 20. |
Как использовать TikTok Creative Center Top Ads API
Отфильтруйте топовую рекламу и получайте результаты постранично.
- Отправьте {"query": "skincare", "time_range": "30d", "sort_by": "likes"} методом POST на /v1/tiktok-creative-center/top-ads.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте объявления из results.items и передавайте results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"skincare","time_range":"30d","sort_by":"likes"}'
# Each item's id can be sent to TikTok Creative Center Ad Analysis.Сценарии использования TikTok Creative Center Top Ads API
- Подборка референсов для категории товаров: Ищите по ключевому слову товара и сохраняйте подписи, видео и duration_seconds лидирующих объявлений как набор референсов для дизайнеров и монтажеров.
- Отличие новых хуков от проверенных временем: Запустите одно ключевое слово с 7d и со 180d: объявления, которые есть в обоих периодах, — это форматы, которые продолжают работать, а объявления только из короткого периода — текущие эксперименты.
- Отбор по CTR внутри одной цели: Получите большую выборку, сгруппируйте ее по objective и ранжируйте каждую группу по ctr, чтобы найти объявления, которые стоит изучить подробнее.
- Массовая разметка хуков и форматов: Передавайте подписи, видеофайлы и длительность в собственный пайплайн разметки, чтобы подсчитать, какие типы хуков и длительности преобладают в категории.
Практические советы по TikTok Creative Center Top Ads API
- Сравнивайте ctr только между объявлениями из одной выборки и с одной целью: единица измерения не документирована, а в результате нет данных о бюджете или предложении, поэтому ранжируйте объявления друг относительно друга, а не относительно общего ориентира CTR в TikTok.
- sort_by поддерживает только relevance и likes, поэтому запрашивайте больший results_limit и сортируйте по ctr в своем коде.
- Обрабатывайте поля с осторожностью: industry и objective возвращаются как коды меток Creative Center, например campaign_objective_video_view, а advertiser и число комментариев, репостов и просмотров в metrics в документированном примере равны null.
- Сохраняйте id каждого объявления при каждом запуске и удаляйте дубли по нему, поскольку одно и то же объявление может вернуться по разным запросам и периодам.
- Отправляйте в TikTok Creative Center Ad Analysis только id из короткого списка: он стоит 1 кредит за объявление и добавляет страны показа и посекундные кривые.
Связанные API
Помимо TikTok Creative Center Top Ads API, используйте эти API, когда нужен другой тип публичных данных TikTok Creative Center.
- TikTok Creative Center Ad Analysis API — Разбирайте одно популярное объявление посекундно по кривым CTR и удержания.
- TikTok Creative Center Trending Hashtags API — Получайте рейтинг трендовых хештегов страны с числом публикаций, просмотрами и кривыми популярности.
- TikTok Creative Center Hashtag Insights API — Изучайте кривую популярности одного трендового хештега, ведущие страны и примеры видео.
- TikTok Creative Center Top Videos API — Получайте чарт самых успешных видео страны с просмотрами и коэффициентом вовлеченности.
- TikTok Creator Marketplace API — Получайте карточки Creator Marketplace с демографией подписчиков, медианными просмотрами и стартовыми ставками.