TikTok Creative Centerреклама TikTokтрендовые хештегиCreator Marketplaceруководство по API

TikTok Creative Center API: топовая реклама, трендовые хештеги и ставки авторов

Шесть новых эндпоинтов SocQ читают TikTok Creative Center: топовую рекламу с посекундными кривыми удержания, трендовые хештеги по странам, чарты топовых видео и карточки Creator Marketplace.

SocQОбновлено 19 ноября 2026 г.7 мин чтения

TikTok Creative Center — это место, где маркетологи смотрят самую эффективную рекламу, хештеги, набирающие популярность в стране, и видео во главе чартов. Creator Marketplace добавляет данные об аудитории и стартовые ставки авторов. 2026-11-17 SocQ добавил шесть эндпоинтов, которые возвращают эти данные в формате JSON; они перечислены на странице платформы TikTok Creative Center.

Шесть эндпоинтов работают тремя парами. Эндпоинт-список находит кандидатов, а эндпоинт подробностей берет ID из этого списка и возвращает детальные данные. В этом руководстве разобрана каждая пара: что она возвращает, как выглядит запрос, сколько он стоит и когда его использовать.

Коротко: отправьте JSON-тело на POST https://api.socq.ai/v1/tiktok-creative-center/<endpoint>. Сохраните возвращенный task_id, опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, затем читайте data.results.items.

Новые эндпоинты TikTok Creative Center

1 кредит SocQ = $0.005. Эндпоинты-списки тарифицируются за результат, без базовой платы.

ЭндпоинтЧто возвращаетЦена
Top Ads APIСамая эффективная реклама с подписью, рекламодателем, отраслью, целью кампании, CTR, лайками и видео0.5 кредита ($0.0025) за объявление
Ad Analysis APIПодробности одного объявления, процентиль показов и посекундные кривые кликабельности и удержания1 кредит ($0.005) за вызов
Trending Hashtags APIХештеги в тренде в стране с местом, числом публикаций, просмотрами и дневной кривой популярности0.5 кредита ($0.0025) за хештег
Hashtag Insights APIИтоги по одному хештегу, кривая популярности, топ стран и ID примеров видео0.5 кредита ($0.0025) за вызов
Top Videos APIЧарт топовых видео страны с местом, автором, просмотрами за период чарта и за все время и показателями вовлеченности0.5 кредита ($0.0025) за видео
Creator Marketplace APIКарточки авторов с распределением подписчиков по возрасту, полу, стране и устройству, медианными просмотрами, уровнем вовлеченности и стартовой ставкой0.5 кредита ($0.0025) за автора

Аутентификация и асинхронные задачи

Все запросы аутентифицируются API-ключом. Один и тот же заголовок используется для отправки задачи, проверки статуса и получения результатов:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Каждый сбор данных выполняется как фоновая задача:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Вызов отправки сразу возвращает data.task_id и data.status. Опрашивайте задачу по этому ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Когда status равен succeeded, ответ содержит result_count, credits_amount и первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500. Если results.has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. Задача с ошибкой содержит error_message.

Каждый эндпоинт здесь также принимает необязательный callback_url. SocQ отправит один POST со сводкой задачи после ее завершения; записи читайте через эндпоинт задачи. Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же ID задачи, а не отправляйте ее повторно. 402 означает, что у аккаунта закончились кредиты, а 429 — что ключ достиг лимита запросов или кредитов.

Top Ads и Ad Analysis: собираем библиотеку референсов

Top Ads API просматривает рекламу, которую TikTok Creative Center относит к самой эффективной. Каждое объявление возвращается с подписью, рекламодателем, отраслью, целью кампании, ctr, лайками и полным видео. Все поля необязательны: query ищет совпадения в подписях объявлений и брендах, time_range принимает значения 7d, 30d (по умолчанию) или 180d, а sort_by — relevance (по умолчанию) или likes. По умолчанию results_limit равен 20, допустимы значения от 1 до 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"}'

Ad Analysis API принимает id одного результата Top Ads как ad_id. Помимо подробностей объявления, стран и посадочной страницы, он возвращает impressions_percentile относительно сопоставимых объявлений, click_through_curve и retention_curve, каждую как значение на каждую секунду видео. Читайте обе кривые вместе, чтобы найти хук, момент, когда зрители уходят, и момент, когда они совершают действие. (документация)

curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/ad-analysis" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ad_id": "7697084527089729557"}'

Когда использовать: креативное исследование для новой кампании. Получите 20 топовых объявлений в своей категории (10 кредитов), затем проанализируйте пять самых релевантных (5 кредитов). Итого 15 кредитов, или $0.075.

Trending Hashtags API возвращает хештеги, набирающие популярность в одной стране, каждый с местом, числом публикаций, числом просмотров и дневной popularity_curve за период. Все поля необязательны: country — двухбуквенный код (по умолчанию US), а time_range принимает значения 7d (по умолчанию), 30d или 90d. По умолчанию results_limit равен 20, допустимы значения от 1 до 100. (документация)

curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "US", "time_range": "7d", "results_limit": 20}'

Hashtag Insights API принимает id из Trending Hashtags как hashtag_id вместе с тем же country. Он возвращает итоговое число публикаций и просмотров, дневную кривую популярности, top_countries с оценкой того, насколько тег популярен относительно размера каждой страны, и video_ids примеров видео. По умолчанию time_range равен 7d. (документация)

curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}'

Когда использовать: выбор хештегов для запуска на конкретном рынке или проверка того, глобальный тег или локальный, прежде чем строить вокруг него контент. Чтобы оценить любой хештег, который вы уже имеете в виду, в том числе не трендовый, TikTok Hashtag Views API возвращает общее число видео и просмотров для до 20 тегов сразу.

Top Videos и Creator Marketplace: авторы и их ставки

Top Videos API читает чарт самых эффективных видео страны в TikTok Creative Center. У каждой записи есть место, подпись, автор, creator_id, просмотры за период чарта, органические просмотры, просмотры за все время, уровень вовлеченности и доля шестисекундных просмотров. Все поля необязательны: country по умолчанию US, period принимает значения daily (по умолчанию), weekly или long_term, а sort_by — views (по умолчанию), engagement_rate или six_second_view_rate. Используется последний опубликованный чарт. По умолчанию results_limit равен 20, допустимы значения от 1 до 100. (документация)

curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "US", "period": "daily", "results_limit": 20}'

Creator Marketplace API принимает от 1 до 20 числовых creator_ids, например значения creator_id из Top Videos. Каждый автор с карточкой возвращает распределение подписчиков по возрасту, полу, стране и устройству, число подписчиков, медианные просмотры, уровень вовлеченности, темп роста подписчиков, долю шестисекундных просмотров, ID недавних видео и starting_price, указанную автором за спонсорское видео. Оплачиваются только авторы с карточкой. (документация)

curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_ids": ["7011198409688219653", "7070293872819044358"]}'

Когда использовать: составление шорт-листа авторов с учетом бюджета. Дневной чарт на 20 видео (10 кредитов) и карточки 20 авторов (10 кредитов) стоят 20 кредитов, или $0.10.

Как это сочетается с другими эндпоинтами TikTok

Данные Creative Center агрегирует сам TikTok: чарты, рейтинги и кривые. Для собственного профиля, видео и комментариев автора используйте эндпоинты из руководства по парсингу TikTok. Страны подписчиков по публичному аккаунту автора и проверка накрученных просмотров описаны в руководстве по новым эндпоинтам TikTok. Реклама в Meta разобрана в статье API для Facebook Ad Library.

FAQ

Нужен ли аккаунт TikTok Ads или Creator Marketplace?

Нет. Вы аутентифицируетесь API-ключом SocQ и отправляете поля, показанные выше.

Откуда берется ad_id?

Из результата Top Ads: передайте его id в Ad Analysis как ad_id. Точно так же id из Trending Hashtags передается в Hashtag Insights как hashtag_id, а creator_id из Top Videos — в Creator Marketplace.

Какие страны можно запрашивать?

Trending Hashtags, Hashtag Insights и Top Videos принимают двухбуквенный код country, например US, GB или JP, по умолчанию US. Для Hashtag Insights используйте тот же country, по которому вы нашли хештег.

Всегда ли есть стартовая ставка автора?

Ставка входит в карточку Creator Marketplace, и результат возвращают только авторы с карточкой. Как и в других полях SocQ, значение, которое источник не предоставляет, возвращается как null.

Как оплачиваются пустые результаты?

У эндпоинтов с оплатой за результат нет базовой платы, поэтому вызов, который ничего не вернул, ничего не стоит. Ad Analysis и Hashtag Insights оплачиваются один раз за вызов.

TIKTOK CREATIVE CENTER API

Проверить сценарий на публичном URL TikTok Creative Center

Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.

API для TikTok Creative Center