TikTok Song Videos
Отслеживание видео, связанных с общей аудиодорожкой, показывает, как авторы интерпретируют вирусные челленджи и трендовую фоновую музыку. Нормализованные элементы видео содержат контекст автора, подписи, ссылки на воспроизведение и видимые метрики вовлеченности по каждому кластеру звука.
Возможности TikTok Song Videos API
- Сбор видео по звукуОтправьте один или несколько числовых ID фрагментов звука, чтобы собрать видео, опубликованные именно с этим аудио.
- Контекст автора и публикацииФиксируйте имя пользователя и псевдоним автора, полный текст подписи, хештеги и упоминания для каждого возвращенного видео.
- Разбивка вовлеченностиИзвлекайте число просмотров, лайков, комментариев, пересылок и сохранений, чтобы сравнивать результаты видео с одним и тем же треком.
- Ссылки для загрузки медиаПолучайте прямые URL обложки и видеопотока вместе с метаданными о размерах и длительности.
Параметры TikTok Song Videos API
| Параметры | Обязательный | Описание |
|---|---|---|
music_ids | Обязательный | Массив числовых ID фрагментов звука TikTok, для которых собираются публичные видео. |
results_limit | Необязательный | Максимальное число возвращаемых видео на каждый ID звука; по умолчанию 100, допустимый диапазон — от 1 до 2 000. |
Как использовать TikTok Song Videos API
Отправьте список ID фрагментов звука как асинхронную задачу, а затем постранично читайте нормализованные результаты по видео.
- Передайте массив числовых ID фрагментов в music_ids и необязательный results_limit до 2 000.
- Отправьте POST-запрос на /v1/tiktok/song-videos со своим API-ключом SocQ.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте data.results.items и переходите по next_cursor для получения следующих страниц.
curl -X POST "https://api.socq.ai/v1/tiktok/song-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"music_ids":["7439295283975702544"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.Сценарии использования TikTok Song Videos API
- Анализ кампаний с вирусным звуком: Оценивайте, насколько эффективно брендированный звук или промо-аудиотрек распространяется в сообществах авторов.
- Исследование креативных паттернов: Анализируйте распространенные визуальные форматы, хореографию или скетчи, которые используют авторы с одним и тем же аудиофрагментом.
- Поиск самого успешного UGC: Находите самые успешные пользовательские видео, связанные с определенной трендовой музыкой, для лицензирования или сотрудничества.
Практические советы по TikTok Song Videos API
- Берите числовой music_id из эндпоинта TikTok Song или из конца веб-URL музыки TikTok.
- Результаты возвращаются в обратном хронологическом порядке или по популярности — в зависимости от ленты звука на платформе.
- Используйте results_limit, чтобы ограничить число результатов на звук; в задачах с несколькими ID пагинация по каждому ID звука идет независимо.
- Проверяйте extra.clip_id в каждом элементе видео, чтобы сопоставлять элементы с входным ID звука.
Связанные API
Помимо TikTok Song Videos API, используйте эти API, когда нужен другой тип публичных данных TikTok.
- TikTok Comments API — Собирайте публичные комментарии верхнего уровня, авторов, вовлеченность, упоминания и признаки взаимодействия с автором видео.
- TikTok Videos API — Получайте по URL видео автора, подпись, медиа, музыку, теги, упоминания и вовлеченность.
- TikTok User Videos API — Собирайте публичные видео из ленты профиля по имени пользователя: подписи, авторы, медиа, метки времени, вовлеченность и контекст исходного аккаунта.
- TikTok Trending Feed API — Собирайте текущую публичную ленту видео для региона: автор, подпись, обложка, метка времени и видимая вовлеченность.
- TikTok Video Transcript API — Извлекайте доступный текст расшифровки, язык, формат и контекст источника по URL публичных видео.
- TikTok Song API — Получайте публичные метаданные звука по ID клипа или URL музыки.
- TikTok Profiles API
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API