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ètres | Obligatoire | Description |
|---|---|---|
chart_type | Facultatif | Choix 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_limit | Facultatif | Nombre 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.
- 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.
- 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é.
- 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.
- 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é.
- 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.
API associées
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.
- TikTok Profiles API
- TikTok Hashtags API
- TikTok Comments API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API