TikTokTikTok Popular Songs APITikTok Trending Sounds APITop 50Viral 50Classements musicaux

API TikTok Music Chart : obtenir le Top 50 et le Viral 50

Constituez une présélection de titres TikTok avec les classements Top 50 et Viral 50 de SocQ. Récupérez les ID de sons et les nombres d’utilisations, avec exemples de requêtes et exports JSON et CSV.

SocQMis à jour le 16 octobre 20267 min de lecture

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=top ou chart_type=viral à POST /v1/tiktok/popular-songs. Conservez l’ID de tâche renvoyé, attendez la réussite et lisez data.results.items. Par défaut, c’est le Top 50 avec une limite de 20 ; results_limit accepte les entiers de 1 à 50.

Choisir le Top 50 ou le Viral 50

EntréeClassement sélectionnéQuand l’utiliser
chart_type: "top"Top 50 de l’application TikTokConstituer une liste à partir de ce classement nommé
chart_type: "viral"Viral 50 de l’application TikTokConstituer une liste Viral 50 ou comparer ses ID de sons avec le Top 50
chart_type omisTop 50Utiliser 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