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, а затем получите их карточки.
- Запустите TikTok Creative Center Top Videos и скопируйте creator_id авторов, которых хотите оценить.
- Отправьте {"creator_ids": ["7011198409688219653", "7070293872819044358"]} методом POST на /v1/tiktok-creative-center/creator-cards.
- Опрашивайте 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 и считайте это начальной суммой автора, поскольку итоговые ставки согласуются для каждого проекта отдельно.
Связанные API
Помимо 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 — Получайте чарт самых успешных видео страны с просмотрами и коэффициентом вовлеченности.