Constituez votre présélection de titres TikTok avec SocQ. Rassemblez les entrées des classements, les ID de sons, les artistes et le nombre de vidéos qui les utilisent, puis reliez chaque son à ses détails et à des vidéos d’exemple pour obtenir un brief de contenu appuyé sur des sources.
L’API SocQ TikTok Popular Songs lit les classements Top 50 et Viral 50 de l’application TikTok. Ce guide présente le choix du classement, les requêtes, les exports JSON et CSV, ainsi que la recherche de vidéos à partir d’un ID de son.
Réponse rapide : envoyez
chart_type=topouchart_type=viralàPOST /v1/tiktok/popular-songs. Conservez l’ID de tâche renvoyé, attendez la réussite et lisezdata.results.items. Par défaut, c’est le Top 50 avec une limite de 20 ;results_limitaccepte les entiers de 1 à 50.
Choisir le Top 50 ou le Viral 50
| Entrée | Classement sélectionné | Quand l’utiliser |
|---|---|---|
chart_type: "top" | Top 50 de l’application TikTok | Constituer une liste à partir de ce classement nommé |
chart_type: "viral" | Viral 50 de l’application TikTok | Constituer une liste Viral 50 ou comparer ses ID de sons avec le Top 50 |
chart_type omis | Top 50 | Utiliser le classement par défaut |
Lorsque vous collectez les deux classements, enregistrez chart_type avec chaque enregistrement. Conservez les deux observations lorsqu’un son figure dans les deux listes, et utilisez audio.id pour rapprocher le son d’un classement à l’autre.
chart_type sélectionne le classement et results_limit fixe le plafond de collecte. Viral 50 est le nom d’un classement de l’application TikTok. Les filtres par pays, les filtres par date et les mesures de croissance sont traités dans la FAQ ci-dessous.
Demander le classement des titres
Définissez SOCQ_API_KEY dans votre environnement et envoyez la requête :
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}'
Remplacez top par viral pour sélectionner le Viral 50. Définissez results_limit sur 50 pour collecter jusqu’à 50 entrées de ce classement ; le result_count de la tâche indique le nombre réellement enregistré.
La réponse de soumission contient data.task_id. Affectez cette valeur à TASK_ID, puis interrogez la tâche existante :
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Patientez tant que l’état est queued, running ou retrying. Lisez data.results.items après succeeded ; examinez data.error_message après failed. Conservez l’ID de tâche lorsqu’une requête client expire, afin de pouvoir reprendre l’interrogation.
results_limit fixe le plafond de collecte. Dans la récupération d’une tâche, limit définit la taille de page et cursor identifie la page enregistrée suivante. Le plafond de collecte des titres est de 50 entrées.
Identifier le son derrière chaque titre
Cet exemple d’enregistrement de titre montre l’ID du son, le titre, l’artiste, le nombre de vidéos qui l’utilisent et l’heure de collecte :
{
"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"
}
Utilisez audio.id pour les appels suivants. Enregistrez-le sous forme de chaîne et importez-le comme texte dans les tableurs afin de conserver tous les chiffres. Le rapprochement par ID de son distingue des sons différents qui portent le même titre.
metrics.videos_count est le total déclaré de vidéos qui utilisent le son. Null signifie que la source a omis la mesure ; 0 est un nombre nul effectivement renvoyé. Pour comparer des relevés, rapprochez les ID de sons et calculez la différence entre les deux nombres.
cover_url contient l’adresse de la pochette et audio.url celle de l’audio. Lorsque audio.url est null, utilisez l’ID du son, le titre et l’artiste pour organiser la liste. Vérifiez la réponse d’une URL audio au moment d’accéder au média.
Exporter une liste de sons en JSON et en CSV avec Python
Enregistrez l’utilitaire de tâche suivant sous le nom socq_collect.py. Il utilise la bibliothèque standard de Python, affiche l’ID de tâche et lit chaque page de résultats enregistrée :
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")
Enregistrez cet export sous le nom export_songs.py dans le même répertoire :
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
Chaque commande crée une tâche de collecte distincte. Le JSON conserve les enregistrements d’origine et la requête ; le CSV est un tableau de relecture. Dans le CSV, les textes publics qui ressemblent à des formules sont échappés, tandis que le JSON conserve les valeurs d’origine. Importez les ID de sons comme texte dans les tableurs.
Enregistrez les exports par date de capture. Comparer le metrics.videos_count d’un même son donne la différence entre ces deux observations. Étiquetez un son absent d’un classement ultérieur comme « non observé lors de cette capture » ; vérifiez ce son séparément pour déterminer s’il a été supprimé.
Trouver les vidéos qui utilisent un son renvoyé
Choisissez un son dans l’export et transmettez son audio.id à 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}'
Cela crée une tâche de collecte de vidéos distincte, avec son propre results_limit. Utilisez TikTok Song pour les détails d’un son, ou le tutoriel de recherche TikTok pour étudier un sujet à travers les vidéos et les publications d’images.
Pour un brief de contenu, conservez ensemble l’ID du son, le type de classement, l’heure de capture, l’URL source et les vidéos d’exemple, afin qu’un relecteur puisse vérifier chaque élément.
Mettre les classements au service de votre veille musicale
SocQ relie la récupération des classements, les détails des sons et la recherche de vidéos associées au sein du même workflow de tâches. Utilisez le code d’export pour organiser la veille par classement et par heure de capture, puis ajoutez des vidéos d’exemple à chaque son. Votre prochaine présélection part d’enregistrements que vous pouvez relire et réutiliser.
Ouvrir l’API Popular Songs et constituer votre présélection.
FAQ
S’agit-il d’une API de sons TikTok en tendance ?
Oui. Son périmètre couvre les classements Top 50 et Viral 50 de l’application TikTok. Sélectionnez un classement avec chart_type et organisez les sons renvoyés par ID.
Puis-je choisir un pays ou une période ?
La collecte est organisée par type de classement. Les entrées prises en charge sont chart_type, results_limit et, en option, callback_url pour la fin de la tâche. Les filtres par pays, par date, par nouvelle entrée et par musique commerciale ne sont pas proposés.
Puis-je obtenir plus de 50 titres grâce à la pagination ?
Chaque tâche collecte jusqu’à 50 entrées. La pagination des résultats lit les titres déjà enregistrés par cette tâche.
Le Viral 50 inclut-il un score de croissance ou une variation de rang ?
L’enregistrement standard fournit des informations sur le son et le nombre de vidéos qui l’utilisent ; les scores de croissance et les variations de rang n’y figurent pas. Enregistrez des captures répétées et calculez les différences par ID de son pour comparer les observations.
Un ID de son identifie-t-il tous les enregistrements d’un même morceau ?
Un ID de son identifie un seul son TikTok. Enregistrez les extraits ou les versions distincts sous leurs propres ID, même s’ils partagent le titre d’un morceau.
Puis-je télécharger chaque titre ou filtrer la musique autorisée pour un usage professionnel ?
Lorsque audio.url a une valeur, essayez cette adresse pour accéder à l’audio. Lorsqu’il est null, conservez l’ID du son pour une recherche de détails. L’éligibilité à un usage commercial exige une vérification distincte ; cet endpoint ne fournit ni champ d’approbation ni filtre correspondant.
Comment obtenir les vidéos qui utilisent l’un des titres ?
Envoyez l’audio.id renvoyé dans le tableau music_ids à TikTok Song Videos. C’est une tâche distincte, avec sa propre limite de collecte et sa propre facturation. Consultez la page de l’API Popular Songs pour connaître les entrées et la facturation actuelles.
TIKTOK API
Tester le workflow avec une URL publique TikTok
Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.
Découvrir les API TikTok