tiktok/
search-music

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

TikTok Sound Search API

Поиск по ключевому слову
Число видео на звук
Сортировка по популярности
0,6 кредита за результат
Готово
Готово

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

README

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

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

Выполните поиск по ключевому слову и пролистайте найденные звуки по страницам.

  1. Отправьте {"query": "lofi", "results_limit": 20} методом POST на /v1/tiktok/search-music.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте звуки из 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 отдает их по подписанным ссылкам, которые позже перестают работать.

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

TikTok Sound Search API — FAQ

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

Ищите по названию песни, добавляя исполнителя, если название распространенное, и читайте metrics.videos_count у подходящего результата. Это общее число видео, снятых с этим звуком.

Нет. Функция в приложении TikTok распознает песню, когда ее поют, напевают или играют, а этот эндпоинт ищет по тексту и возвращает звуки, соответствующие названию, исполнителю или настроению. Распознать аудио по записи он не может.

Задайте sort_by равным most_used, чтобы первыми шли самые используемые звуки, или latest, чтобы первыми шли самые новые; relevance, значение по умолчанию, упорядочивает звуки по степени соответствия ключевому слову.

Возьмите id звука из результата и отправьте его в TikTok Song Videos — этот эндпоинт собирает видео, опубликованные с этим звуком.

На рынке США, если только вы не передаете region с двухбуквенным кодом страны — тогда поиск выполняется на рынке TikTok этой страны.

results_limit принимает значения от 1 до 500, по умолчанию 20. Каждый возвращенный звук стоит 0,6 кредита, а поиск без совпадений ничего не стоит.