tiktok-creative-center/
creator-cards

Получайте карточки TikTok Creator Marketplace до 20 авторов по ID: распределение подписчиков по возрасту, полу, стране и устройству, медианные просмотры, вовлеченность и стартовая ставка.

TikTok Creator Marketplace API

До 20 авторов
Демография аудитории
Стартовые ставки
0,5 кредита за результат
Готово
Готово

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

README

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

TikTok Creator Marketplace

Карточка TikTok Creator Marketplace — это профиль, который видят бренды, когда оценивают автора для платного сотрудничества: в ней описание профиля и число подписчиков дополнены распределением подписчиков по возрасту, полу, стране и устройству, медианными просмотрами, коэффициентами вовлеченности и роста, а также стартовой ставкой, которую автор указывает за спонсорское видео. Такие карточки позволяют брендам сравнивать авторов по соответствию аудитории, типичным результатам и цене в одном представлении.

Возможности TikTok Creator Marketplace API

  • Четыре разреза аудиторииaudience делит подписчиков по возрастной группе, полу, стране и марке телефона, и каждая запись — это доля от 0 до 1.
  • Ориентиры эффективностиmetrics содержит followers_count, median_views, engagement_rate, followers_growth_rate и six_second_view_rate.
  • Указанная стартовая ставкаstarting_price возвращает сумму и валюту, которые автор указывает за спонсорское видео, в виде числа, пригодного для расчетов.
  • До 20 авторов в одном запросеcreator_ids принимает от 1 до 20 ID Creator Marketplace и возвращает по одной карточке для каждого автора, у которого она есть.
  • Идентификация в каждой карточкеusername, name, текст описания профиля, avatar_url, region, tiktok_user_id, url и recent_video_ids связывают Marketplace ID с реальным аккаунтом.

Параметры TikTok Creator Marketplace API

ПараметрыОбязательныйОписание
creator_idsОбязательныйОт 1 до 20 ID Creator Marketplace, например значения creator_id из результатов TikTok Creative Center Top Videos.

Как использовать TikTok Creator Marketplace API

Соберите ID авторов из Top Videos, а затем получите их карточки.

  1. Запустите TikTok Creative Center Top Videos и скопируйте creator_id авторов, которых хотите оценить.
  2. Отправьте {"creator_ids": ["7011198409688219653", "7070293872819044358"]} методом POST на /v1/tiktok-creative-center/creator-cards.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, и читайте по одной карточке на автора из results.items.
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"]}'

# audience.ages, genders, countries and devices are shares from 0 to 1.

Сценарии использования TikTok Creator Marketplace API

  • Проверка соответствия аудитории: Сравнивайте audience.ages, genders и countries авторов из короткого списка с клиентом, которого хотите охватить, и отсеивайте авторов, чьи подписчики находятся не на тех рынках.
  • Сравнение стоимости просмотра: Делите starting_price.amount на median_views, чтобы сравнить, что дает указанная ставка каждого автора, вместо сравнения числа подписчиков.
  • Рейтинг по динамике: Сортируйте короткий список по engagement_rate и followers_growth_rate, чтобы найти авторов, у которых аудитория активно реагирует и число подписчиков продолжает расти.

Практические советы по TikTok Creator Marketplace API

  • Берите ID из поля creator_id строк Top Videos: ID пользователя TikTok, например author.id, не соответствует карточке и пропускается.
  • Считайте каждый разрез аудитории списком долей, сумма которых может быть немного меньше 1, и сопоставляйте записи по метке, а не по позиции.
  • Читайте starting_price.amount вместе с currency и считайте это начальной суммой автора, поскольку итоговые ставки согласуются для каждого проекта отдельно.

Помимо TikTok Creator Marketplace API, используйте эти API, когда нужен другой тип публичных данных TikTok Creative Center.

  • TikTok Creative Center Top Ads API — Просматривайте самую эффективную рекламу по ключевому слову и периоду: подписи, CTR, лайки и видео объявления.
  • 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 Creative Center с публичными данными других поддерживаемых соцсетей.

TikTok Creator Marketplace API — FAQ

TikTok Creator Marketplace API — это программный интерфейс для получения карточек TikTok Creator Marketplace до 20 авторов по их ID Creator Marketplace. Он возвращает распределение подписчиков по возрасту, полу, стране и устройству, медианные просмотры, коэффициенты вовлеченности и роста, стартовые ставки и данные об идентичности автора.

ID Creator Marketplace, который возвращается как creator_id в строках Top Videos и состоит из 5–32 цифр. Обычный ID пользователя TikTok не указывает на карточку, а значения в других форматах отклоняются с ошибкой 400.

У авторов, которые присоединились к Creator Marketplace TikTok и заполнили профиль; критерии допуска устанавливает TikTok, включая пороги по возрасту и числу подписчиков, которые зависят от проекта. ID без карточки пропускается и не оплачивается, а если пропущены все ID, задача завершается с ошибкой и кредиты возвращаются. Каждая возвращенная карточка стоит 0,5 кредита.

Четыре разреза подписчиков автора: возрастные группы с метками вроде 18-24 или 55+, пол, страна и марка телефона, у каждой записи — доля от 0 до 1. Для стран также указываются country_code и число подписчиков в выборке.

starting_price содержит сумму и валюту, которые автор указывает как стартовую цену за спонсорское видео. Это начальная сумма: авторы сами устанавливают стартовые ставки, а итоговая цена согласуется для каждого проекта отдельно.

Нет, поиск выполняется по ID Creator Marketplace. Кандидатов берут из TikTok Creative Center Top Videos, где каждая строка чарта содержит creator_id.

От TikTok — нет. Запрос выполняется только с вашим API-ключом SocQ, без брендового аккаунта и партнерского одобрения.