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 музыки как асинхронную задачу, а затем опрашивайте ее, чтобы получить нормализованные данные о треке.
- Возьмите числовой ID фрагмента или URL звука из любой публичной публикации TikTok или ссылки «Поделиться» на звук.
- Отправьте POST-запрос на /v1/tiktok/song, указав music_id или url.
- Опрашивайте /v1/tasks/{task_id} до завершения задачи.
- Получите нормализованный объект музыки из 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.
Связанные API
Помимо 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 Hashtags API
- TikTok Comments API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Video Transcript 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