tiktok/
song

Собирайте подробные публичные метаданные звуков и музыки TikTok по ID фрагмента или URL звука: исполнитель, альбом, длительность, ссылки на аудио и число видео с этим звуком.

TikTok Song API

Данные о звуке
Метаданные аудио
Распространение трека
0,5 кредита за результат
Готово
Готово

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

README

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

TikTok Song

Музыка и аудиодорожки — основа вирусных трендов коротких видео. Метаданные звука содержат название аудио, данные об исполнителе, длительность, прямые ссылки на поток для воспроизведения и текущее число видео, в которых используется звук.

Возможности TikTok Song API

  • Два способа указать звукЗапрашивайте данные по числовому ID фрагмента или по полному URL публичной страницы звука TikTok — на выбор.
  • Метаданные трека и исполнителяИзвлекайте официальное название песни, хендл и псевдоним исполнителя, название альбома и URL обложки.
  • Поток для предпрослушиванияПолучайте публичные URL для воспроизведения аудио и точные значения длительности для интеграции с медиа.
  • Метрика объема использованияОтслеживайте счетчик user_count, который показывает, сколько публичных видео создано с этим звуком.

Параметры TikTok Song API

ПараметрыОбязательныйОписание
music_idОбязательный (хотя бы один)Числовой ID фрагмента звука TikTok, например 7439295283975702544. Обязателен, если url не указан.
urlОбязательный (хотя бы один)Прямой URL публичной страницы звука или музыки TikTok. Обязателен, если music_id не указан.

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

Отправьте ID фрагмента звука или URL музыки как асинхронную задачу, а затем опрашивайте ее, чтобы получить нормализованные данные о треке.

  1. Возьмите числовой ID фрагмента или URL звука из любой публичной публикации TikTok или ссылки «Поделиться» на звук.
  2. Отправьте POST-запрос на /v1/tiktok/song, указав music_id или url.
  3. Опрашивайте /v1/tasks/{task_id} до завершения задачи.
  4. Получите нормализованный объект музыки из data.results.items.
curl -X POST "https://api.socq.ai/v1/tiktok/song" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"music_id":"7439295283975702544"}'

# Or pass {"url":"https://www.tiktok.com/music/Different-Acoustic-6717159721276540930"}

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

  • Отслеживание жизненного цикла тренда: Следите за изменением числа видео со звуком во времени, чтобы понять, ускоряется аудиотренд или выходит на плато.
  • Обогащение музыкального каталога: Дополняйте каталоги исполнителей ID платформы TikTok, обложками звуков и данными о длительности аудио.
  • Исследование креативов на основе аудио: Находите оригинального исполнителя и данные о треке за вирусными аудиофрагментами, которые используются в коротких видео.

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

  • URL музыки TikTok содержат ID фрагмента в конце пути; принимается как полный URL, так и сам ID.
  • Передайте полученный music_id в TikTok Song Videos, чтобы получить именно те видео, в которых используется этот трек.
  • Свойство metrics.videos_count отражает общее число публичных видео, в которых используется этот аудиофрагмент.
  • У оригинальных звуков, созданных обычными пользователями, в дополнительных метаданных is_original равно true.

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

  • TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
  • TikTok Videos API — Получайте по URL видео автора, подпись, медиа, музыку, теги, упоминания и вовлеченность.
  • TikTok Search API — Ищите публичные видео по ключевому слову с поддерживаемой сортировкой и фильтрами по дате публикации.
  • TikTok User Videos API — Собирайте публичные видео из ленты профиля по имени пользователя: подписи, авторы, медиа, метки времени, вовлеченность и контекст исходного аккаунта.
  • TikTok Trending Feed API — Собирайте текущую публичную ленту видео для региона: автор, подпись, обложка, метка времени и видимая вовлеченность.
  • TikTok Song Videos API — Собирайте публичные видео с заданными ID звуков.

Другие платформы

Объединяйте данные TikTok с публичными данными других поддерживаемых соцсетей.

TikTok Song API — FAQ

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

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

Нет. Этот эндпоинт получает метаданные для известного ID или URL звука; чтобы найти видео с этим звуком, используйте TikTok Song Videos.