tiktok/
search-music

Busque sonidos de TikTok por palabra clave y vea cuántos videos usa cada uno, con ID del sonido, título, artista, portada, duración y vista previa, ordenados por relevancia, uso o fecha.

TikTok Sound Search API

Búsqueda por palabra clave
Videos por sonido
Orden por más usados
0.6 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

TikTok Sound Search

Un sonido de TikTok es el audio asociado a un video, ya sea una canción de la biblioteca de música o un clip que grabó un creador, y cada uno tiene su propia página con título, artista o autor, portada y un conteo acumulado de los videos hechos con él. Ese conteo es la lectura más rápida para saber si un sonido es de nicho, ya está establecido o está despegando, y el ID del sonido es lo que une una pista con los videos que la usan.

Funcionalidades de la TikTok Sound Search API

  • Búsqueda por título, artista o ambientequery acepta el título de una canción, el nombre de un artista o un ambiente como lofi, y devuelve los sonidos que TikTok asocia con ello.
  • Videos por sonidometrics.videos_count es el total de videos que usan cada sonido, así los temas consolidados se distinguen de los de nicho.
  • Tres órdenes de clasificaciónsort_by ordena los resultados por relevance, most_used o latest, de modo que una misma palabra clave responde qué está comprobado y qué es nuevo.
  • Selección de mercadoregion recibe un código de país de dos letras para buscar en ese mercado de TikTok, y por defecto vale US.
  • Registro del sonido con vista previaCada resultado incluye la url de la página del sonido, audio.id, title, artist, cover_url, duration_seconds y un audio.url que se puede reproducir.

Parámetros de la TikTok Sound Search API

ParámetrosObligatorioDescripción
queryObligatorioTítulo de la canción, artista o nombre del sonido que se busca.
sort_byOpcionalOrden de los resultados: relevance (predeterminado), most_used o latest.
regionOpcionalCódigo de país de dos letras del mercado de TikTok donde se busca. El valor predeterminado es US.
results_limitOpcionalCuántos sonidos se devuelven, de 1 a 500. El valor predeterminado es 20.

Cómo usar la TikTok Sound Search API

Busque con una palabra clave y recorra por páginas los sonidos que coinciden.

  1. Envíe {"query": "lofi", "results_limit": 20} por POST a /v1/tiktok/search-music.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea los sonidos en results.items y devuelva results.next_cursor mientras has_more sea 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.

Casos de uso de la TikTok Sound Search API

  • Preseleccionar sonidos para un video de marca: Busque un ambiente con sort_by en most_used y revise videos_count, duration_seconds y la vista previa del audio para quedarse con sonidos probados que calcen con la duración de su clip.
  • Detectar sonidos nuevos a tiempo: Repita la misma palabra clave con sort_by en latest y conserve los sonidos con un videos_count todavía bajo, antes de que aparezcan en los resúmenes de tendencias.
  • Encontrar el ID de sonido de una canción: Busque el título de una canción junto con su artista, compare audio.artist y conserve audio.id para seguir los videos que usan exactamente ese sonido.
  • Listas de sonidos por mercado: Repita una consulta con distintos códigos en region para armar una lista aparte de cada país en el que corre una campaña.

Consejos de expertos para la TikTok Sound Search API

  • Para una canción con licencia, busque el título junto con el artista, porque un título corto como Lofi coincide con muchos sonidos sin relación; confirme audio.artist antes de conservar un audio.id.
  • Elimine duplicados por id al combinar búsquedas de varias palabras clave, ya que un mismo sonido puede responder a más de una consulta.
  • Trate videos_count como un total acumulado y no como una tasa de crecimiento; para ver qué sonidos se aceleran, ejecute la misma consulta de forma periódica y compare los conteos entre ejecuciones.
  • Descargue audio.url y cover_url poco después de que termine la tarea si necesita los archivos, porque TikTok los sirve con enlaces firmados que dejan de funcionar más tarde.

Además de la TikTok Sound Search API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok.

  • TikTok Hashtags API — Recolecta videos públicos, creadores, contenido multimedia, sonido e interacción de los hashtags indicados.
  • TikTok Search API — Busca videos públicos por palabra clave con filtros de orden y de publicación compatibles.
  • TikTok Live Room Info API — Consulta una transmisión en vivo conocida mediante el par de IDs de la sala y del propietario, y devuelve su estado, el contexto del propietario, la portada y los conteos de audiencia.
  • TikTok Song API — Obtiene los metadatos de un sonido público por ID de clip o URL de música.
  • TikTok Song Videos API — Recolecta videos públicos que usan los IDs de sonido indicados.
  • TikTok Popular Songs API — Obtiene la clasificación Top 50 o Viral 50 de canciones de la app de TikTok, con nombres de pistas, artistas, IDs de sonido y cantidad de videos disponible.

Explorar otras plataformas

Combine los datos de TikTok con datos públicos de otras plataformas sociales compatibles.

TikTok Sound Search API — FAQ

TikTok Sound Search API es una interfaz programática para buscar sonidos de TikTok por palabra clave, como el título de una canción, un artista o un ambiente. Devuelve el ID, el título, el artista, la portada, la duración, la vista previa del audio y la cantidad de videos que usan cada sonido.

Busque el título de la canción y agregue el artista si el título es común, y lea metrics.videos_count en el resultado que coincida. Es el total de videos hechos con ese sonido.

No. La función de la app reconoce una canción a partir de que se cante, se tararee o se reproduzca, mientras que este endpoint busca por texto y devuelve los sonidos que coinciden con un título, un artista o un ambiente. No puede identificar un audio a partir de una grabación.

Configure sort_by en most_used para mostrar primero los sonidos más usados y en latest para los más nuevos; relevance, el valor predeterminado, sigue qué tanto coincide un sonido con la palabra clave.

Tome el id del sonido del resultado y envíelo a TikTok Song Videos, que reúne los videos publicados con ese sonido.

En el de US, salvo que envíe region como un código de país de dos letras; en ese caso la búsqueda se hace en el mercado de TikTok de ese país.

results_limit acepta de 1 a 500 y vale 20 por defecto. Cada sonido devuelto se factura a 0.6 créditos, y una búsqueda sin coincidencias no cuesta nada.