tiktok/
song-videos

Collectez les vidéos TikTok publiques qui utilisent un son précis, avec métadonnées de vidéo normalisées, détails du créateur, légendes, liens médias et compteurs d’engagement.

TikTok Song Videos API

Vidéos liées à un audio
Défis autour d’un son
Regroupement de tendances
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

TikTok Song Videos

Suivre les vidéos associées à une même piste audio montre comment les créateurs s’approprient des défis viraux et des musiques de fond tendance. Les vidéos normalisées renvoient le contexte du créateur, les légendes, les liens de lecture et les métriques d’engagement visibles pour chaque groupe de son.

Fonctionnalités de la TikTok Song Videos API

  • Collecte centrée sur le sonEnvoyez un ou plusieurs ID numériques d’extraits sonores pour rassembler les vidéos publiées avec cette identité audio exacte.
  • Contexte du créateur et de la publicationCapturez pour chaque vidéo renvoyée le nom d’utilisateur et le pseudo du créateur, la légende complète, les hashtags et les mentions.
  • Détail de l’engagementExtrayez les nombres de vues, de mentions J’aime, de commentaires, de partages et d’enregistrements pour comparer les performances des vidéos utilisant la même piste.
  • Liens de téléchargement des médiasRecevez les URL directes de l’image de couverture et du flux vidéo, avec dimensions et durée.

Paramètres de la TikTok Song Videos API

ParamètresObligatoireDescription
music_idsObligatoireTableau d’ID numériques d’extraits sonores TikTok dont il faut collecter les vidéos publiques.
results_limitFacultatifNombre maximal de vidéos à renvoyer par ID de son ; vaut 100 par défaut, sur une plage de 1 à 2 000.

Comment utiliser la TikTok Song Videos API

Envoyez une liste d’ID d’extraits sonores comme tâche asynchrone, puis parcourez page par page les vidéos normalisées.

  1. Fournissez un tableau d’ID d’extraits numériques dans music_ids et, si besoin, un results_limit allant jusqu’à 2 000.
  2. Envoyez une requête POST à /v1/tiktok/song-videos avec votre clé API SocQ.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que le statut soit succeeded.
  4. Lisez data.results.items et suivez next_cursor pour obtenir les pages suivantes.
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":["7439295283975702544"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Cas d’usage de la TikTok Song Videos API

  • Analyse de campagnes autour d’un son viral : Évaluez l’efficacité avec laquelle un son de marque ou une piste audio promotionnelle se diffuse dans les communautés de créateurs.
  • Étude des schémas créatifs : Analysez les formats visuels, chorégraphies ou sketchs les plus courants adoptés par les créateurs qui utilisent le même extrait audio.
  • Repérage de contenus UGC performants : Identifiez les vidéos générées par les utilisateurs les plus performantes associées à une musique tendance précise, en vue d’une licence ou d’une collaboration.

Conseils d’expert pour la TikTok Song Videos API

  • Obtenez le music_id numérique auprès de l’endpoint TikTok Song ou à la fin d’une URL web de musique TikTok.
  • Les résultats sont renvoyés par ordre chronologique inverse ou par popularité, selon les flux de sons de la plateforme.
  • Utilisez results_limit pour plafonner les résultats par son ; dans une tâche à plusieurs ID, chaque ID de son est paginé indépendamment.
  • Vérifiez extra.clip_id sur chaque vidéo pour rapprocher les éléments de l’ID de son envoyé.

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

  • TikTok Comments API — Collectez les commentaires publics de premier niveau, leurs auteurs, l’engagement, les mentions et les indicateurs d’interaction du créateur.
  • 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.

Explorer d’autres plateformes

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

TikTok Song Videos API — FAQ

TikTok Song Videos API collecte les vidéos publiques utilisant un son ou un ID d’extrait musical TikTok précis. Elle renvoie les publications vidéo normalisées, les détails de l’auteur, les légendes, les liens médias et les métriques d’engagement visibles pour analyser tendances et défis.

music_ids accepte un tableau d’ID d’extraits numériques sous forme de chaînes, comme ["7439295283975702544"], que l’on trouve sur les pages de sons TikTok.

Oui. Vous pouvez fournir un tableau de plusieurs ID d’extraits ; chaque son est traité et renvoyé dans le résultat agrégé de la tâche.