tiktok-creative-center/
top-ads

Получайте самую эффективную рекламу из TikTok Creative Center по ключевому слову, периоду 7, 30 или 180 дней и порядку сортировки: подписи, CTR, лайки, цель, отрасль и видео объявления.

TikTok Creative Center Top Ads API

Самая эффективная реклама
CTR каждого объявления
Видеофайлы объявлений
0,5 кредита за результат
Готово
Готово

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

README

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

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

Отфильтруйте топовую рекламу и получайте результаты постранично.

  1. Отправьте {"query": "skincare", "time_range": "30d", "sort_by": "likes"} методом POST на /v1/tiktok-creative-center/top-ads.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте объявления из 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 кредит за объявление и добавляет страны показа и посекундные кривые.

Помимо 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 с демографией подписчиков, медианными просмотрами и стартовыми ставками.

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

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

TikTok Creative Center Top Ads API — FAQ

TikTok Creative Center Top Ads API — это программный интерфейс для сбора самой эффективной рекламы из TikTok Creative Center с фильтрацией по ключевому слову, периоду и порядку сортировки. Он возвращает подпись, отрасль, цель, CTR, лайки и видео каждого объявления.

Нет. Top Ads — это отобранный список эффективных объявлений с CTR и лайками, а TikTok Ad Library — архив прозрачности с объявлениями, которые показывались; в нем ищут по рекламодателю или ключевому слову, и CTR он не дает.

Нет. Top Ads показывает только объявления, рекламодатели которых разрешили Creative Center их показывать, поэтому это выборка лучших объявлений, а не полный реестр. Для поиска по рекламодателю используйте эндпоинты TikTok Ad Library.

Не в этом эндпоинте: он фильтрует по ключевому слову и time_range. Отрасль и цель возвращаются в каждом объявлении, поэтому фильтруйте по ним после запроса, а страны показа объявления получайте через TikTok Creative Center Ad Analysis.

sort_by принимает только relevance или likes. Запросите до 300 объявлений и отсортируйте их по возвращенному ctr самостоятельно.

Каждое возвращенное объявление стоит 0,5 кредита, поэтому 300 объявлений стоят 150 кредитов. Запрос, который не вернул ни одного объявления, не оплачивается.

Запись media каждого объявления содержит URL видео, миниатюру, размер и длительность, поэтому файл можно загрузить. Видео принадлежат рекламодателям, поэтому используйте их для исследований и как референс, а не для повторной публикации.