tiktok/
search-music

Recherchez des sons TikTok par mot-clé et voyez combien de vidéos utilisent chacun, avec ID du son, titre, artiste, pochette, durée et aperçu, triés par pertinence, par usage ou par récence.

TikTok Sound Search API

Recherche par mot-clé
Vidéos par son
Tri par usage
0,6 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 Sound Search

Un son TikTok est la piste audio attachée à une vidéo, soit un titre de la bibliothèque musicale, soit un extrait enregistré par un créateur ; chacun a sa propre page, avec un titre, un artiste ou un auteur, une pochette et le nombre de vidéos réalisées avec lui. Ce compteur est le moyen le plus rapide de savoir si un son reste confidentiel, s’est installé ou commence à monter, et l’ID du son relie une piste aux vidéos qui l’utilisent.

Fonctionnalités de la TikTok Sound Search API

  • Recherche par titre, artiste ou ambiancequery accepte un titre de chanson, un nom d’artiste ou une ambiance comme lofi, et renvoie les sons que TikTok y associe.
  • Nombre de vidéos par sonmetrics.videos_count est le nombre total de vidéos qui utilisent chaque son : les titres installés se distinguent ainsi des sons de niche.
  • Trois ordres de trisort_by classe les résultats par relevance, most_used ou latest : un même mot-clé fait ressortir à la fois ce qui a fait ses preuves et ce qui vient d’arriver.
  • Choix du marchéregion accepte un code pays à deux lettres pour chercher sur ce marché TikTok, et vaut US par défaut.
  • Fiche du son avec aperçuChaque résultat contient l’url de la page du son, audio.id, title, artist, cover_url, duration_seconds et un audio.url que vous pouvez lire.

Paramètres de la TikTok Sound Search API

ParamètresObligatoireDescription
queryObligatoireTitre de chanson, artiste ou nom de son à rechercher.
sort_byFacultatifOrdre des résultats : relevance (par défaut), most_used ou latest.
regionFacultatifCode pays à deux lettres du marché TikTok à interroger. US par défaut.
results_limitFacultatifNombre de sons à renvoyer, de 1 à 500. 20 par défaut.

Comment utiliser la TikTok Sound Search API

Cherchez avec un mot-clé et parcourez page par page les sons correspondants.

  1. Envoyez {"query": "lofi", "results_limit": 20} en POST à /v1/tiktok/search-music.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les sons dans results.items et renvoyez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/tiktok/search-music" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"lofi","sort_by":"most_used","results_limit":20}'

# metrics.videos_count is the number of videos using each sound.

Cas d’usage de la TikTok Sound Search API

  • Présélectionner des sons pour une vidéo de marque : Cherchez une ambiance avec sort_by most_used, puis vérifiez videos_count, duration_seconds et l’aperçu audio pour garder les sons éprouvés qui conviennent à la durée de votre clip.
  • Repérer tôt les nouveaux sons : Relancez le même mot-clé avec sort_by latest et gardez les sons dont videos_count reste faible, avant qu’ils n’entrent dans les sélections de tendances.
  • Retrouver l’ID du son d’un titre : Cherchez un titre de chanson avec son artiste, rapprochez audio.artist, et conservez audio.id pour suivre les vidéos qui utilisent exactement ce son.
  • Des listes de sons par marché : Répétez une requête avec différents codes region pour constituer une présélection distincte pour chaque pays où se déroule une campagne.

Conseils d’expert pour la TikTok Sound Search API

  • Cherchez le titre avec l’artiste pour un morceau sous licence : un titre court comme Lofi correspond à de nombreux sons sans rapport, alors vérifiez audio.artist avant de conserver un audio.id.
  • Dédoublonnez sur id quand vous fusionnez les recherches de plusieurs mots-clés, car un même son peut répondre à plus d’une requête.
  • Considérez videos_count comme un total cumulé, pas comme un rythme de croissance : pour savoir quels sons accélèrent, relancez la même requête à intervalles réguliers et comparez les compteurs d’une exécution à l’autre.
  • Téléchargez audio.url et cover_url peu après la fin de la tâche si vous avez besoin des fichiers : TikTok les sert par des liens signés qui cessent de fonctionner par la suite.

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

  • TikTok Hashtags API — Collectez les vidéos publiques, créateurs, médias, sons et l’engagement pour des hashtags donnés.
  • TikTok Search API — Recherchez des vidéos publiques par mot-clé avec tris et filtres de publication pris en charge.
  • TikTok Live Room Info API — Consultez un live connu à partir de la paire d’ID de salle et de propriétaire, et obtenez le statut, le contexte du propriétaire, le média de couverture et les nombres d’audience.
  • 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 Popular Songs API — Obtenez le classement des 50 morceaux du Top 50 ou du Viral 50 de TikTok, avec titres, artistes, ID de son et nombre de vidéos disponible.

Explorer d’autres plateformes

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

TikTok Sound Search API — FAQ

TikTok Sound Search API est une interface programmatique pour rechercher des sons TikTok par mot-clé, par exemple un titre de chanson, un artiste ou une ambiance. Elle renvoie pour chaque son l’ID, le titre, l’artiste, la pochette, la durée, un aperçu audio et le nombre de vidéos qui l’utilisent.

Cherchez le titre de la chanson, en ajoutant l’artiste quand le titre est courant, et lisez metrics.videos_count sur le résultat correspondant. C’est le nombre total de vidéos réalisées avec ce son.

Non. La fonction intégrée à TikTok reconnaît un morceau chanté, fredonné ou joué, alors que cet endpoint cherche par texte et renvoie les sons qui correspondent à un titre, un artiste ou une ambiance. Il ne peut pas identifier un son à partir d’un enregistrement.

Réglez sort_by sur most_used pour afficher d’abord les sons les plus utilisés, ou sur latest pour les plus récents d’abord ; relevance, la valeur par défaut, suit la proximité entre le son et le mot-clé.

Prenez l’id du son dans le résultat et envoyez-le à TikTok Song Videos, qui collecte les vidéos publiées avec ce son.

Aux États-Unis, sauf si vous passez region sous forme de code pays à deux lettres : la recherche porte alors sur le marché TikTok de ce pays.

results_limit accepte de 1 à 500, avec 20 par défaut. Chaque son renvoyé est facturé 0,6 crédit, et une recherche sans résultat ne coûte rien.