TikTokAPI de canciones populares de TikTokAPI de sonidos en tendencia de TikTokTop 50Viral 50Listas de música

API de listas de música de TikTok: obtenga el Top 50 y el Viral 50

Cree una preselección de canciones de TikTok con las listas Top 50 y Viral 50 de SocQ. Obtenga IDs de sonidos y conteos de uso, con ejemplos de solicitudes y exportaciones a JSON y CSV.

SocQActualizado el 16 de octubre de 20267 min de lectura

Cree su preselección de canciones de TikTok con SocQ. Reúna las entradas de las listas, los IDs de los sonidos, los artistas y los conteos de uso en videos, y luego conecte cada sonido con sus detalles y videos de ejemplo para armar un brief de contenido respaldado por la fuente.

La TikTok Popular Songs API de SocQ lee las listas Top 50 y Viral 50 de la app de TikTok. Esta guía cubre la selección de la lista, las solicitudes, las exportaciones a JSON y CSV, y la búsqueda de videos por ID de sonido.

Respuesta rápida: Envíe chart_type=top o chart_type=viral a POST /v1/tiktok/popular-songs. Guarde el ID de tarea devuelto, espere a que termine con éxito y lea data.results.items. El valor predeterminado es Top 50 con un límite de 20; results_limit acepta enteros de 1 a 50.

Elegir entre Top 50 y Viral 50

EntradaLista seleccionadaCuándo usarla
chart_type: "top"Top 50 de la app de TikTokCrear una lista a partir de esta lista con nombre
chart_type: "viral"Viral 50 de la app de TikTokCrear una lista del Viral 50 o comparar sus IDs de sonidos con el Top 50
Omitir chart_typeTop 50Usar la lista predeterminada

Cuando recopile ambas listas, guarde chart_type junto con cada registro. Conserve las dos observaciones cuando un sonido aparezca en ambas listas y use audio.id para hacer coincidir el sonido entre ellas.

chart_type selecciona la lista y results_limit define el tope de la recopilación. Viral 50 es el nombre de una lista de la app de TikTok. Los filtros por país, los filtros por fecha y las mediciones de crecimiento se tratan en las preguntas frecuentes más abajo.

Solicitar la lista de canciones

Defina SOCQ_API_KEY en su entorno y envíe la solicitud:

curl -X POST "https://api.socq.ai/v1/tiktok/popular-songs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chart_type":"top","results_limit":20}'

Cambie top por viral para seleccionar el Viral 50. Defina results_limit en 50 para recopilar hasta 50 entradas de esa lista; el result_count de la tarea indica la cantidad real guardada.

La respuesta del envío contiene data.task_id. Asigne ese valor a TASK_ID y luego consulte la tarea existente:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Espere mientras el estado sea queued, running o retrying. Lea data.results.items después de succeeded; revise data.error_message después de failed. Conserve el ID de la tarea cuando una solicitud del cliente agote el tiempo de espera, para poder reanudar la consulta.

results_limit define el tope de la recopilación. En la obtención de resultados de la tarea, limit define el tamaño de la página y cursor identifica la siguiente página guardada. El tope de recopilación de canciones es de 50 entradas.

Identificar el sonido de cada canción

Este ejemplo de registro de canción muestra el ID del sonido, el título, el artista, el conteo de uso en videos y la hora de recopilación:

{
  "id": "6711980022204205826",
  "type": "music",
  "name": "we fell in love in october",
  "audio": {
    "id": "6711980022204205826",
    "title": "we fell in love in october",
    "artist": "girl in red"
  },
  "duration_seconds": 42,
  "metrics": {"videos_count": 2031150},
  "collected_at": "2026-10-15T08:12:54.524359Z"
}

Use audio.id para las llamadas de seguimiento. Guárdelo como cadena de texto e impórtelo como texto en las hojas de cálculo para conservar todos los dígitos. Hacer la coincidencia por ID de sonido permite distinguir sonidos distintos que comparten título.

metrics.videos_count es el total informado de videos que usan el sonido. Null significa que la fuente omitió la medición; 0 es un conteo devuelto de cero. Para comparar capturas, haga coincidir los IDs de los sonidos y calcule la diferencia entre los dos conteos.

cover_url contiene la dirección de la portada y audio.url contiene la dirección del audio. Cuando audio.url es null, use el ID del sonido, el título y el artista para organizar la lista. Revise la respuesta de una URL de audio al acceder al medio.

Exportar una lista de sonidos a JSON y CSV con Python

Guarde el siguiente asistente de tareas como socq_collect.py. Usa la biblioteca estándar de Python, imprime el ID de la tarea y lee todas las páginas de resultados guardadas:

import json
import os
import time
from urllib.parse import urlencode
from urllib.request import Request, urlopen

BASE = "https://api.socq.ai/v1"
PENDING = {"queued", "running", "retrying"}

def api(method, path, payload=None):
    body = json.dumps(payload).encode("utf-8") if payload is not None else None
    request = Request(
        BASE + path, data=body, method=method,
        headers={
            "Authorization": "Bearer " + os.environ["SOCQ_API_KEY"],
            "Content-Type": "application/json",
        },
    )
    with urlopen(request, timeout=60) as response:
        result = json.load(response)
    if result.get("code") != 200:
        raise RuntimeError(result)
    return result["data"]

def collect(endpoint, payload):
    task_id = api("POST", "/" + endpoint, payload)["task_id"]
    print("Task:", task_id, flush=True)
    path = "/tasks/" + task_id
    deadline = time.monotonic() + 600
    data = api("GET", path + "?limit=100")
    while data["status"] in PENDING:
        if time.monotonic() >= deadline:
            raise TimeoutError("Resume GET " + path + "; do not resubmit automatically")
        time.sleep(2)
        data = api("GET", path + "?limit=100")
    if data["status"] != "succeeded":
        raise RuntimeError(data.get("error_message") or data["status"])

    items, seen_cursors = [], set()
    while True:
        if time.monotonic() >= deadline:
            raise TimeoutError("Resume pagination for " + task_id)
        page = data["results"]
        items.extend(page["items"])
        if not page["has_more"]:
            return task_id, items
        cursor = page.get("next_cursor")
        if not cursor or cursor in seen_cursors:
            raise RuntimeError("Missing or repeated result cursor")
        seen_cursors.add(cursor)
        data = api("GET", path + "?" + urlencode({"limit": 100, "cursor": cursor}))
        if data["status"] != "succeeded":
            raise RuntimeError("Task is not ready for result pagination")

Guarde esta exportación como export_songs.py en el mismo directorio:

import csv
import json
import sys
from socq_collect import collect

chart = sys.argv[1] if len(sys.argv) > 1 else "top"
if chart not in {"top", "viral"}:
    raise SystemExit("Usage: python3 export_songs.py [top|viral]")
payload = {"chart_type": chart, "results_limit": 20}
task_id, items = collect("tiktok/popular-songs", payload)
with open(f"songs-{chart}.json", "w", encoding="utf-8") as f:
    json.dump({"task_id": task_id, "input": payload, "items": items},
              f, ensure_ascii=False, indent=2)

fields = ["chart_type", "sound_id", "title", "artist", "videos_count",
          "duration_seconds", "url", "collected_at"]
def csv_cell(value):
    if value is None:
        return ""
    if isinstance(value, str) and value.lstrip().startswith(("=", "+", "-", "@")):
        return "'" + value
    return value

with open(f"songs-{chart}.csv", "w", encoding="utf-8-sig", newline="") as f:
    writer = csv.DictWriter(f, fieldnames=fields)
    writer.writeheader()
    for item in items:
        audio = item.get("audio") or {}
        row = {"chart_type": chart, "sound_id": audio.get("id"),
               "title": item.get("name"), "artist": audio.get("artist"),
               "videos_count": (item.get("metrics") or {}).get("videos_count"),
               "duration_seconds": item.get("duration_seconds"),
               "url": item.get("url"), "collected_at": item.get("collected_at")}
        writer.writerow({k: csv_cell(v) for k, v in row.items()})
python3 export_songs.py top
python3 export_songs.py viral

Cada comando crea una tarea de recopilación independiente. El JSON conserva los registros originales y la solicitud; el CSV es una tabla de revisión. El texto público con apariencia de fórmula se escapa en el CSV, mientras que el JSON conserva los valores originales. Importe los IDs de los sonidos como texto en las hojas de cálculo.

Guarde las exportaciones por fecha de captura. Comparar el metrics.videos_count del mismo sonido da la diferencia entre esas dos observaciones. Etiquete un sonido ausente de una lista posterior como “no observado en esta captura”; revise el sonido individual por separado para investigar si fue eliminado.

Encontrar los videos que usan un sonido devuelto

Elija un sonido de la exportación y pase su audio.id a TikTok Song Videos:

curl -X POST "https://api.socq.ai/v1/tiktok/song-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"music_ids":["6711980022204205826"],"results_limit":20}'

Esto crea una tarea independiente de recopilación de videos, con su propio results_limit. Use TikTok Song para los detalles del sonido, o el tutorial de búsqueda en TikTok para investigar un tema en videos y publicaciones de imágenes.

Para un brief de contenido, conserve juntos el ID del sonido, el tipo de lista, la hora de captura, la URL de origen y los videos de ejemplo, de modo que quien lo revise pueda verificar cada elemento.

Ponga las listas a trabajar en su investigación musical

SocQ conecta la obtención de listas, los detalles de los sonidos y la búsqueda de videos relacionados mediante el mismo flujo de tareas. Use el código de exportación para organizar la investigación por lista y hora de captura, y luego agregue videos de ejemplo a cada sonido. Su próxima preselección comienza con registros que puede revisar y reutilizar.

Abra la Popular Songs API y cree su preselección.

Preguntas frecuentes (FAQ)

¿Es esta una API de sonidos en tendencia de TikTok?

Sí. Su alcance son las listas Top 50 y Viral 50 de la app de TikTok. Seleccione una lista con chart_type y organice los sonidos devueltos por ID.

¿Puedo elegir un país o un rango de fechas?

La recopilación se organiza por tipo de lista. Las entradas admitidas son chart_type, results_limit y el callback_url opcional de finalización de la tarea. No se ofrecen filtros por país, fecha, entradas nuevas ni música comercial.

¿Puedo obtener más de 50 canciones con paginación?

Cada tarea recopila hasta 50 entradas. La paginación de resultados lee las canciones que esa tarea ya guardó.

¿El Viral 50 incluye una puntuación de crecimiento o un cambio de posición?

El registro estándar ofrece información del sonido y conteos de uso en videos; no incluye puntuaciones de crecimiento ni cambios de posición. Guarde capturas repetidas y calcule las diferencias por ID de sonido al comparar observaciones.

¿Un ID de sonido identifica todas las grabaciones de una misma canción?

Un ID de sonido identifica un solo sonido de TikTok. Guarde los clips o versiones distintos con sus propios IDs, aunque compartan el título de la canción.

¿Puedo descargar todas las canciones o filtrar la música aprobada para uso comercial?

Cuando audio.url tiene un valor, pruebe esa dirección para acceder al audio. Cuando es null, conserve el ID del sonido para consultar sus detalles. La elegibilidad para uso comercial requiere una verificación aparte; este endpoint no ofrece un campo de aprobación ni un filtro correspondiente.

¿Cómo obtengo los videos que usan una de las canciones?

Envíe el audio.id devuelto en el arreglo music_ids a TikTok Song Videos. Es una tarea independiente, con su propio límite de recopilación y su propia facturación. Consulte la página de la Popular Songs API para ver las entradas y los detalles de facturación vigentes.

TIKTOK API

Probar el flujo de trabajo con una URL pública de TikTok

Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.

Ver las API de TikTok