Ко всем API
Исследовательские данные TikTok Creative Center

TikTok Creative Center API

Превращайте рейтинги TikTok Creative Center в данные, к которым можно отправлять запросы: самая эффективная реклама, трендовые хештеги по странам, чарты топовых видео и карточки Creator Marketplace.

Доступные API TikTok Creative Center

Top Ads, Trending Hashtags и Top Videos читают рейтинги, а Ad Analysis, Hashtag Insights и Creator Marketplace позволяют подробнее изучить одно объявление, один хештег или группу авторов из этих рейтингов.

Какие данные Creative Center можно получить?

Каждый эндпоинт возвращает стабильные записи SocQ, построенные на том, что Creative Center показывает для выбранного объявления, хештега, чарта или автора.

Самая эффективная реклама

Подпись объявления, отрасль, цель, оценка CTR, лайки и видео для объявлений, которые отбирает Creative Center, а для отдельного объявления — еще и целевые страны, процентиль показов и посекундные кривые CTR и удержания.

Трендовые хештеги

Рейтинги по странам за 7, 30 или 90 дней с позицией, числом публикаций и просмотров и ежедневной кривой популярности; Hashtag Insights добавляет для одного тега ведущие страны по оценке и ID примеров видео.

Чарты топовых видео

Ежедневные, еженедельные и долгосрочные чарты по странам: подпись, автор, просмотры за период, органические просмотры и просмотры за все время, коэффициент вовлеченности, доля 6-секундных просмотров и Marketplace ID автора.

Карточки Creator Marketplace

Распределение подписчиков по возрасту, полу, стране и устройству, медианные просмотры, коэффициенты вовлеченности и роста подписчиков, а также стартовая ставка, которую каждый автор указывает за спонсорское видео.

SocQ и TikTok Creative Center

Creative Center — исследовательский сайт TikTok, где рейтинги просматривают в веб-интерфейсе. SocQ возвращает те же рейтинги в виде API-записей, которые можно хранить, сравнивать и объединять.

ВозможностьSocQTikTok Creative Center
ДоступAPI-ключ и JSON-записиВеб-интерфейс
Массовый сборДо 300 объявлений, 100 хештегов или 100 видео за задачуПостраничный просмотр
Углубленный анализID из одного рейтинга передаются в следующий эндпоинтРучной переход между страницами
РезультатСтабильные поля SocQ с описаниямиВизуальные графики и карточки

Как работают API TikTok Creative Center

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

  1. 1. Прочитайте рейтинг

    Отправьте фильтры в Top Ads, Trending Hashtags или Top Videos — например, ключевое слово, страну или период.

  2. 2. Опрашивайте задачу

    Используйте возвращенный task_id с /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.

  3. 3. Изучите подробнее

    Отправьте id объявления в Ad Analysis, id хештега в Hashtag Insights или значения creator_id в Creator Marketplace.

Начните с одного запроса к API

Пройдите аутентификацию с API-ключом SocQ. Top Ads по умолчанию возвращает 20 результатов и принимает до 300.

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"}'

# Then analyze one ad:
# POST /v1/tiktok-creative-center/ad-analysis
# {"ad_id":"7697084527089729557"}
# Poll GET /v1/tasks/{task_id}

Типичные сценарии использования TikTok Creative Center API

Поиск рекламы конкурентов

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

Диагностика оттока зрителей

Отправьте id из Top Ads в Ad Analysis и посекундно сравните click_through_curve с retention_curve, чтобы увидеть, где зрители кликают, а где уходят.

Отслеживание хештегов по рынкам

Регулярно получайте трендовые хештеги каждой целевой страны и по popularity_curve смотрите, какие теги еще растут, прежде чем планировать публикации.

Бенчмаркинг хуков и охвата

Ранжируйте чарт видео страны по six_second_view_rate и сравнивайте organic_views_count с views_count, чтобы понять, какие вступления удерживают зрителей, а какие видео в основном продвигались платно.

Отбор авторов

Берите значения creator_id из чартов видео и сравнивайте доли аудитории, медианные просмотры, вовлеченность и указанную стартовую ставку в карточках Creator Marketplace.

Охват данных

Результаты соответствуют тому, что Creative Center публикует для каждого рейтинга, рынка и периода.

  • Top Ads показывает объявления, которые проходят пороги эффективности Creative Center и разрешены их рекламодателями, поэтому это отобранная подборка, а не вся реклама в TikTok.
  • Чарты видео публикуются с задержкой: около двух дней для ежедневного чарта и недели, заканчивающиеся воскресеньем, для еженедельного; рынок без чарта возвращает ноль результатов, и плата не списывается.
  • Карточки Creator Marketplace есть только у авторов, зарегистрированных в Creator Marketplace TikTok, и ищутся по Marketplace ID, поэтому ID, взятые из других источников, не подходят.
  • Рейтинги хештегов принимают только страну и временное окно, без фильтра по отрасли, а ведущие страны и примеры видео строки рейтинга оставляют для Hashtag Insights.
  • Оценки CTR, процентили и значения популярности — относительные показатели, которые сообщает Creative Center, а не отчетность по кампаниям на уровне аккаунта.

Частые вопросы о TikTok Creative Center API

Что такое TikTok Creative Center API?

TikTok Creative Center API — это программный интерфейс для получения топовой рекламы, трендовых хештегов, чартов топовых видео и карточек Creator Marketplace из TikTok Creative Center в виде нормализованных JSON-записей.

Нужен ли аккаунт TikTok или рекламный аккаунт?

Нет. Запросы используют ваш API-ключ SocQ и читают рейтинги, которые Creative Center публикует на своих публичных исследовательских страницах.

Как перейти от рейтинга к одному объявлению, хештегу или автору?

Каждый рейтинг возвращает ID, который принимает соответствующий эндпоинт с подробными данными: id объявления передается в Ad Analysis, id хештега — в Hashtag Insights вместе с той же страной, а creator_id из Top Videos — в Creator Marketplace.

Чем Top Ads отличается от Top Videos?

Top Ads возвращает платную рекламу TikTok с оценкой CTR, отраслью и целью. Top Videos возвращает чарт видео страны с просмотрами, органическими просмотрами и коэффициентами вовлеченности, а также Marketplace ID каждого автора.

Насколько актуальны данные?

Каждый запрос возвращает то, что Creative Center опубликовал на этот момент, а каждая запись содержит метку времени collected_at. Ежедневные чарты видео отстают от текущей даты примерно на два дня, а еженедельные заканчиваются воскресеньем.

Сколько стоят эндпоинты?

Top Ads, Trending Hashtags, Top Videos и Creator Marketplace стоят 0,5 кредита за каждый возвращенный результат. Ad Analysis стоит 1 кредит, а Hashtag Insights — 0,5 кредита за запрос.

Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.

YouTube API

Собирайте поддерживаемые публичные профили каналов YouTube, данные о видео, видео каналов, комментарии, Shorts, результаты поиска по ключевым словам и хештегам и доступные расшифровки в едином нормализованном асинхронном процессе.

Facebook API

Собирайте публичные профили страниц Facebook, публикации, публикации в группах, комментарии, мероприятия по ключевому слову и доступные расшифровки видео с нормализованными полями идентичности, контента, источника, формата, места, медиа, реакций, посещаемости и вовлеченности.

X API

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

LinkedIn API

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

Reddit API

Получайте публичные публикации и комментарии Reddit по известным URL, просматривайте новые, лучшие или горячие публикации сабреддитов либо ищите обсуждения по ключевому слову и периоду публикации.

Pinterest API

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