tiktok/
song-videos

Собирайте публичные видео TikTok, в которых используется определенный звук, и получайте нормализованные метаданные видео, данные об авторах, подписи, ссылки на медиа и счетчики вовлеченности.

TikTok Song Videos API

Видео со звуком
Челленджи со звуком
Кластеризация трендов
0,5 кредита за результат
Готово
Готово

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

README

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

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 фрагментов звука как асинхронную задачу, а затем постранично читайте нормализованные результаты по видео.

  1. Передайте массив числовых ID фрагментов в music_ids и необязательный results_limit до 2 000.
  2. Отправьте POST-запрос на /v1/tiktok/song-videos со своим API-ключом SocQ.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
  4. Читайте 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 звука.

Помимо 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 с публичными данными других поддерживаемых соцсетей.

TikTok Song Videos API — FAQ

TikTok Song Videos API собирает публичные видео, в которых используется определенный звук TikTok или ID музыкального фрагмента. Он возвращает нормализованные видео, данные об авторах, подписи, ссылки на медиа и видимые метрики вовлеченности для анализа трендов и челленджей.

music_ids принимает массив числовых ID фрагментов в виде строк, например ["7439295283975702544"], которые можно найти на страницах звуков TikTok.

Да. Можно передать массив из нескольких ID фрагментов; каждый звук будет обработан, а результаты вернутся в общем выводе задачи.