tiktok/
popular-songs

Obtenez le classement TikTok des chansons Top 50 ou Viral 50, avec titres, artistes, ID de sons et nombres de vidéos disponibles, pour constituer une liste musicale à examiner.

TikTok Popular Songs API

Top 50
Viral 50
ID de sons
0,5 crédit par résultat
Prêt
README

Par SocQ · Mis à jour le

TikTok Popular Songs

Un son TikTok est l’audio associé à une publication, et l’application TikTok propose les classements de chansons Top 50 et Viral 50. Chaque enregistrement renvoyé identifie un son précis par son titre, son artiste et son ID de son, ce qui permet de constituer une liste musicale et de relier chaque entrée aux détails du son ou aux vidéos qui l’utilisent.

Fonctionnalités de la TikTok Popular Songs API

  • Choisir l’un des deux classements de chansonsRéglez chart_type sur top pour le Top 50 ou sur viral pour le Viral 50. Ce sont deux classements nommés de l’application TikTok : choisissez celui que vous voulez examiner et demandez jusqu’à 50 entrées.
  • Identifier le son exact derrière un titreLisez ensemble le titre, l’artiste, l’ID du son, la pochette et la durée. L’ID du son aide à distinguer des extraits audio de même nom et permet de consulter ce son précis avec TikTok Song ou TikTok Song Videos.
  • Lire les nombres d’utilisation disponiblesLorsque la source fournit un nombre, metrics.videos_count indique combien de vidéos utilisent ce son. C’est un nombre de vidéos, pas d’auditeurs, de lectures ou de mentions J’aime ; un nombre indisponible reste null.

Paramètres de la TikTok Popular Songs API

ParamètresObligatoireDescription
chart_typeFacultatifChoix de classement facultatif : top sélectionne le Top 50 de l’application TikTok ; viral sélectionne le Viral 50. La valeur par défaut est top. Par exemple, remplacez la valeur de l’exemple par viral pour demander l’autre classement.
results_limitFacultatifNombre maximal de chansons facultatif, entier de 1 à 50 ; vaut 20 par défaut. Par exemple, 10 demande jusqu’à dix entrées du classement choisi. La source peut en renvoyer moins, et la pagination des résultats n’étend pas cette limite.

Comment utiliser la TikTok Popular Songs API

La requête lance une tâche de collecte en arrière-plan : la première réponse donne donc un ID de tâche, et non les données finales ; servez-vous de cet ID pour suivre l’avancement et récupérer les résultats.

  1. Choisissez chart_type : top pour le Top 50 ou viral pour le Viral 50. Si vous l’omettez, l’API utilise top ; results_limit vaut 20 par défaut et accepte un entier de 1 à 50.
  2. Remplacez $SOCQ_API_KEY par votre clé API, ou définissez cette variable d’environnement. Envoyez la requête JSON en POST à /v1/tiktok/popular-songs avec l’en-tête Authorization, puis conservez le task_id renvoyé.
  3. La première réponse contient un ID de tâche, car la collecte s’exécute en arrière-plan. Interrogez GET /v1/tasks/{task_id} ; queued, running et retrying signifient que la tâche est toujours en cours. Lisez les résultats après succeeded, ou consultez error_message après failed.
  4. Lisez data.results.items. Chaque élément décrit un son précis ; audio.id est son ID de son, audio.artist nomme l’artiste et metrics.videos_count est le nombre d’utilisations en vidéos disponible. Un tableau items vide signifie qu’aucun enregistrement n’a été renvoyé.
  5. Si data.results.has_more vaut true, transmettez next_cursor tel quel comme cursor à GET /v1/tasks/{task_id}?cursor=... et continuez jusqu’à ce que has_more vaille false. Cela lit une autre page de la même tâche enregistrée ; cela n’augmente pas la limite de collecte du classement au-delà de 50.
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}'

Cas d’usage de la TikTok Popular Songs API

  • Préparer une feuille de revue musicale : Choisissez le Top 50 ou le Viral 50, puis exportez titres, artistes, ID de sons, durées et nombres de vidéos disponibles dans un tableau. Votre équipe peut ouvrir les pages des sons et juger quels extraits conviennent à une idée de contenu.
  • Rassembler des exemples de vidéos utilisant un son : Transmettez les ID de sons renvoyés comme music_ids à TikTok Song Videos pour collecter des exemples de vidéos publiques. Examinez ces vidéos vous-même pour comprendre comment un extrait est utilisé ; cet endpoint de classement n’effectue pas cette analyse.
  • Comparer des instantanés de classement collectés séparément : Enregistrez à chaque tâche le chart_type choisi, les ID de sons, les nombres de vidéos disponibles et collected_at. Joignez vos tableaux enregistrés par ID de son pour comparer dans le temps les chansons renvoyées et leurs nombres d’utilisations ; l’endpoint lui-même ne fournit pas de classements historiques.

Conseils d’expert pour la TikTok Popular Songs API

  • Gardez chart_type constant lorsque vous comparez des exécutions enregistrées. Passer de top à viral change le classement choisi : une liste de chansons différente ne démontre donc pas, à elle seule, une hausse ou une baisse de popularité.
  • Utilisez audio.id pour relier les enregistrements d’une tâche à l’autre et pour interroger TikTok Song ou TikTok Song Videos. Un titre seul ne permet pas de distinguer des extraits sonores différents portant le même nom.
  • Si audio.url vaut null, conservez l’ID du son et l’URL publique de sa page pour des recherches ultérieures. Lorsqu’une URL audio est fournie, voyez-y un lien média disponible au moment de la collecte, et non une adresse de téléchargement permanente.

En complément de la TikTok Popular Songs API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok.

  • TikTok Videos API — Récupérez le créateur, la légende, les médias, la musique, les tags, les mentions et l’engagement à partir d’URL de vidéos.
  • TikTok User Videos API — Collectez par nom d’utilisateur les vidéos publiques du fil d’un profil avec légendes, créateurs, médias, horodatages, engagement et contexte du compte source.
  • TikTok Trending Feed API — Collectez le fil actuel de vidéos publiques d’une région avec créateur, légende, couverture, horodatage et engagement visible.
  • TikTok Video Transcript API — Extrayez le texte de transcription disponible, la langue, le format et le contexte source à partir d’URL de vidéos publiques.
  • TikTok Song API — Récupérez les métadonnées d’un son public à partir de l’ID du clip ou de l’URL du morceau.
  • TikTok Song Videos API — Collectez les vidéos publiques utilisant des ID de son donnés.

Explorer d’autres plateformes

Combinez les données TikTok avec les données publiques d’autres plateformes sociales prises en charge.

TikTok Popular Songs API — FAQ

TikTok Popular Songs API est une interface qui lit le classement de chansons Top 50 ou Viral 50 de l’application TikTok. Choisissez chart_type et une limite de résultats pour obtenir noms de sons, artistes, ID de sons, pochettes, durées et nombres d’utilisations en vidéos disponibles.

Ils sélectionnent deux classements nommés de l’application TikTok : top correspond au Top 50 et viral au Viral 50. Si chart_type est omis, l’API utilise top. La réponse n’explique pas la formule de classement et ne fournit pas de score de croissance.

Non. Cet endpoint accepte chart_type et results_limit, plus un callback_url facultatif pour la fin de la tâche. Il ne propose ni filtre par pays, par période de classement ou par nouveautés, ni filtre de musique commerciale.

Non. results_limit est compris entre 1 et 50. Un curseur de résultats permet de lire une autre page d’enregistrements déjà sauvegardés par la tâche ; il ne collecte pas d’entrées de classement supplémentaires.

metrics.videos_count est le nombre de vidéos signalées comme utilisant le son. Il ne mesure ni les auditeurs, ni les vues, ni les mentions J’aime. Un nombre null signifie que la source n’a pas fourni cette mesure, tandis que zéro est une valeur réellement renvoyée.

Prenez audio.id dans l’enregistrement de la chanson et transmettez-le dans music_ids à TikTok Song Videos. Pour obtenir les détails d’un son, utilisez ce même ID avec TikTok Song. Ce sont des requêtes distinctes.

Non. audio.url peut valoir null même lorsque le nom, l’artiste et l’ID du son sont disponibles. Lorsqu’une URL est renvoyée, elle permet de consulter l’audio disponible ; l’endpoint ne garantit pas que le lien reste accessible.

Chaque chanson renvoyée coûte 0,5 crédit, sans frais de base. Une limite de 20 donne une estimation de 10 crédits ; si la tâche renvoie 12 chansons, la facturation finale est de 6 crédits. Une limite de 50 donne une estimation de 25 crédits.