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ámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Título de la canción, artista o nombre del sonido que se busca. |
sort_by | Opcional | Orden de los resultados: relevance (predeterminado), most_used o latest. |
region | Opcional | Código de país de dos letras del mercado de TikTok donde se busca. El valor predeterminado es US. |
results_limit | Opcional | Cuá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.
- Envíe {"query": "lofi", "results_limit": 20} por POST a /v1/tiktok/search-music.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- 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.
APIs relacionadas
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.
- 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