TikTok Sound Search
Звук TikTok — это аудио, прикрепленное к видео: трек из музыкальной библиотеки или фрагмент, записанный самим автором, и у каждого звука есть своя страница с названием, исполнителем или автором загрузки, обложкой и растущим числом видео, снятых с ним. Это число быстрее всего показывает, нишевый ли звук, уже известный или набирающий популярность, а ID звука связывает трек с видео, в которых он используется.
Возможности TikTok Sound Search API
- Поиск по названию, исполнителю или настроениюquery принимает название песни, имя исполнителя или настроение, например lofi, и возвращает звуки, которые TikTok сопоставляет с ним.
- Число видео на каждый звукmetrics.videos_count — это общее число видео с каждым звуком, поэтому известные треки сразу отличаются от нишевых.
- Три варианта сортировкиsort_by упорядочивает результаты по relevance, most_used или latest, поэтому одно ключевое слово показывает и проверенные звуки, и новые.
- Выбор рынкаregion принимает двухбуквенный код страны для поиска на соответствующем рынке TikTok, по умолчанию US.
- Запись звука с превьюКаждый результат содержит url страницы звука, audio.id, title, artist, cover_url, duration_seconds и audio.url, который можно воспроизвести.
Параметры TikTok Sound Search API
| Параметры | Обязательный | Описание |
|---|---|---|
query | Обязательный | Название песни, исполнитель или название звука для поиска. |
sort_by | Необязательный | Порядок результатов: relevance (по умолчанию), most_used или latest. |
region | Необязательный | Двухбуквенный код страны рынка TikTok, на котором выполняется поиск. По умолчанию US. |
results_limit | Необязательный | Сколько звуков вернуть, от 1 до 500. По умолчанию 20. |
Как использовать TikTok Sound Search API
Выполните поиск по ключевому слову и пролистайте найденные звуки по страницам.
- Отправьте {"query": "lofi", "results_limit": 20} методом POST на /v1/tiktok/search-music.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте звуки из results.items и передавайте обратно results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/search-music" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"lofi","sort_by":"most_used","results_limit":20}'
# metrics.videos_count is the number of videos using each sound.Сценарии использования TikTok Sound Search API
- Подбор звуков для брендового видео: Ищите по настроению с sort_by most_used, затем проверяйте videos_count, duration_seconds и аудиопревью, чтобы оставить проверенные звуки, подходящие по длине вашего ролика.
- Раннее обнаружение новых звуков: Запускайте то же ключевое слово с sort_by latest и сохраняйте звуки с пока небольшим videos_count, до того как они попадут в обзоры трендов.
- Определение ID звука для трека: Ищите название песни вместе с исполнителем, сверяйте audio.artist и сохраняйте audio.id, чтобы отслеживать видео именно с этим звуком.
- Списки звуков по рынкам: Повторяйте один query с разными кодами region, чтобы составить отдельный шорт-лист для каждой страны, где идет кампания.
Практические советы по TikTok Sound Search API
- Для лицензированного трека ищите название вместе с исполнителем, потому что короткому названию вроде Lofi соответствует много посторонних звуков; проверяйте audio.artist, прежде чем сохранять audio.id.
- Убирайте дубли по id, когда объединяете поиски по нескольким ключевым словам: один звук может совпасть с несколькими запросами.
- Считайте videos_count накопленным итогом, а не темпом роста; чтобы увидеть, какие звуки ускоряются, запускайте один и тот же query по расписанию и сравнивайте числа между запусками.
- Если файлы вам нужны, скачивайте audio.url и cover_url вскоре после завершения задачи: TikTok отдает их по подписанным ссылкам, которые позже перестают работать.
Связанные API
Помимо TikTok Sound Search API, используйте эти API, когда нужен другой тип публичных данных TikTok.
- TikTok Hashtags API — Собирайте публичные видео, авторов, медиа, звук и вовлеченность по заданным хештегам.
- TikTok Search API — Ищите публичные видео по ключевому слову с поддерживаемой сортировкой и фильтрами по дате публикации.
- TikTok Live Room Info API — Получайте данные об одном известном прямом эфире по паре ID эфира и владельца: статус, контекст владельца, обложка и число зрителей.
- TikTok Song API — Получайте публичные метаданные звука по ID клипа или URL музыки.
- TikTok Song Videos API — Собирайте публичные видео с заданными ID звуков.
- TikTok Popular Songs API — Получайте чарт треков TikTok App Top 50 или Viral 50: названия треков, исполнители, ID звуков и доступное число видео.
- TikTok Profiles API
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users 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 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