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=topochart_type=viralaPOST /v1/tiktok/popular-songs. Guarde el ID de tarea devuelto, espere a que termine con éxito y leadata.results.items. El valor predeterminado es Top 50 con un límite de 20;results_limitacepta enteros de 1 a 50.
Elegir entre Top 50 y Viral 50
| Entrada | Lista seleccionada | Cuándo usarla |
|---|---|---|
chart_type: "top" | Top 50 de la app de TikTok | Crear una lista a partir de esta lista con nombre |
chart_type: "viral" | Viral 50 de la app de TikTok | Crear una lista del Viral 50 o comparar sus IDs de sonidos con el Top 50 |
Omitir chart_type | Top 50 | Usar 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