TikTok Creative Center est l’endroit où les marketeurs consultent les publicités les plus performantes, les hashtags en hausse dans un pays et les vidéos en tête des classements. Creator Marketplace y ajoute des données d’audience et les tarifs de départ des créateurs. Le 2026-11-17, SocQ a ajouté six endpoints qui renvoient ces données en JSON, répertoriés sur la page de la plateforme TikTok Creative Center.
Les six endpoints fonctionnent par paires. Un endpoint de liste trouve des candidats, et un endpoint de détail prend l’ID issu de cette liste et renvoie l’analyse approfondie. Ce guide présente chaque paire : ce qu’elle renvoie, la requête, le prix et quand l’utiliser.
Réponse rapide : envoyez un corps JSON à
POST https://api.socq.ai/v1/tiktok-creative-center/<endpoint>. Enregistrez letask_idrenvoyé, interrogezGET /v1/tasks/{task_id}jusqu’à ce questatusvaillesucceeded, puis lisezdata.results.items.
Les nouveaux endpoints TikTok Creative Center
1 crédit SocQ = $0,005. Les endpoints de liste sont facturés au résultat, sans frais de base.
| Endpoint | Ce qu’il renvoie | Prix |
|---|---|---|
| API Top Ads | Les publicités les plus performantes avec légende, annonceur, secteur, objectif, CTR, likes et vidéo | 0,5 crédit ($0,0025) par publicité |
| API Ad Analysis | Les détails d’une publicité, son centile d’impressions et ses courbes de clics et de rétention seconde par seconde | 1 crédit ($0,005) par appel |
| API Trending Hashtags | Les hashtags tendance d’un pays avec rang, publications, vues et courbe de popularité quotidienne | 0,5 crédit ($0,0025) par hashtag |
| API Hashtag Insights | Les totaux d’un hashtag, sa courbe de popularité, ses principaux pays et des ID de vidéos d’exemple | 0,5 crédit ($0,0025) par appel |
| API Top Videos | Le classement des meilleures vidéos d’un pays avec rang, créateur, vues sur la période et au total, et taux d’engagement | 0,5 crédit ($0,0025) par vidéo |
| API Creator Marketplace | Des fiches créateurs avec répartition des abonnés par âge, genre, pays et appareil, vues médianes, taux d’engagement et tarif de départ | 0,5 crédit ($0,0025) par créateur |
Authentification et flux de tâches asynchrones
Toutes les requêtes s’authentifient avec une clé API. Le même en-tête sert pour l’envoi, le statut de la tâche et la récupération des résultats :
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Chaque collecte s’exécute comme une tâche en arrière-plan :
submit -> task_id -> queued -> running -> succeeded
\-> failed
L’appel d’envoi répond immédiatement avec data.task_id et data.status. Interrogez la tâche avec cet ID :
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Lorsque status vaut succeeded, la réponse contient result_count, credits_amount et la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et peut aller jusqu’à 500. Si results.has_more vaut true, passez results.next_cursor comme cursor pour lire la page suivante. Une tâche en échec porte error_message.
Chaque endpoint présenté ici accepte aussi un callback_url facultatif. SocQ envoie un POST avec un résumé de la tâche lorsqu’elle se termine ; lisez les enregistrements depuis l’endpoint des tâches. Un délai d’expiration côté client n’annule pas une tâche : reprenez avec le même ID de tâche au lieu de renvoyer la requête. Un 402 signifie que le compte n’a plus de crédits, et un 429 que la clé a atteint une limite de débit ou de crédits.
Top Ads et Ad Analysis : constituer un swipe file
L’API Top Ads parcourt les publicités que TikTok Creative Center classe parmi les plus performantes. Chaque publicité est fournie avec sa légende, son annonceur, son secteur, l’objectif de campagne, ctr, les likes et la vidéo complète. Tous les champs sont facultatifs : query cherche dans les légendes et les marques, time_range vaut 7d, 30d (par défaut) ou 180d, et sort_by vaut relevance (par défaut) ou likes. results_limit vaut 20 par défaut et accepte de 1 à 300. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "skincare", "time_range": "30d", "sort_by": "likes"}'
L’API Ad Analysis prend l’id d’un résultat Top Ads comme ad_id. En plus des détails de la publicité, de ses pays et de sa page de destination, elle renvoie impressions_percentile par rapport à des publicités comparables, une click_through_curve et une retention_curve, chacune sous forme d’une valeur par seconde de vidéo. Lisez les deux courbes ensemble pour repérer l’accroche, le moment où les spectateurs décrochent et celui où ils passent à l’action. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/ad-analysis" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ad_id": "7697084527089729557"}'
Quand l’utiliser : la recherche créative pour une nouvelle campagne. Récupérez 20 top ads de votre catégorie (10 crédits), puis analysez les cinq plus pertinentes (5 crédits). Soit 15 crédits, ou $0,075.
Trending Hashtags et Hashtag Insights : repérer les hashtags en hausse par pays
L’API Trending Hashtags renvoie les hashtags en hausse dans un pays, chacun avec son rang, son nombre de publications, son nombre de vues et une popularity_curve quotidienne sur la période. Tous les champs sont facultatifs : country est un code à deux lettres (par défaut US), et time_range vaut 7d (par défaut), 30d ou 90d. results_limit vaut 20 par défaut et accepte de 1 à 100. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "time_range": "7d", "results_limit": 20}'
L’API Hashtag Insights prend un id de Trending Hashtags comme hashtag_id, avec le même country. Elle renvoie les totaux de publications et de vues, la courbe de popularité quotidienne, top_countries avec un score indiquant la popularité du hashtag par rapport à la taille de chaque pays, et les video_ids de vidéos d’exemple. time_range vaut 7d par défaut. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}'
Quand l’utiliser : pour choisir les hashtags d’un lancement sur un marché précis, ou vérifier si un hashtag est mondial ou local avant de construire du contenu autour. Pour mesurer un hashtag que vous avez déjà en tête, y compris s’il n’est pas tendance, l’API TikTok Hashtag Views renvoie le total de vidéos et de vues pour jusqu’à 20 hashtags à la fois.
Top Videos et Creator Marketplace : trouver des créateurs et leurs tarifs
L’API Top Videos lit le classement des vidéos les plus performantes d’un pays dans TikTok Creative Center. Chaque entrée comporte son rang, sa légende, son créateur, creator_id, les vues sur la période du classement, les vues organiques, les vues totales, le taux d’engagement et le taux de visionnage à six secondes. Tous les champs sont facultatifs : country vaut US par défaut, period vaut daily (par défaut), weekly ou long_term, et sort_by vaut views (par défaut), engagement_rate ou six_second_view_rate. Le dernier classement publié est utilisé. results_limit vaut 20 par défaut et accepte de 1 à 100. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "period": "daily", "results_limit": 20}'
L’API Creator Marketplace prend de 1 à 20 creator_ids numériques, comme les valeurs creator_id de Top Videos. Chaque créateur disposant d’une fiche renvoie la répartition de ses abonnés par âge, genre, pays et appareil, son nombre d’abonnés, ses vues médianes, son taux d’engagement, son taux de croissance d’abonnés, son taux de visionnage à six secondes, les ID de ses vidéos récentes et le starting_price qu’il affiche pour une vidéo sponsorisée. Seuls les créateurs disposant d’une fiche sont facturés. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"creator_ids": ["7011198409688219653", "7070293872819044358"]}'
Quand l’utiliser : pour constituer une liste restreinte de créateurs en tenant compte du budget. Un classement quotidien de 20 vidéos (10 crédits) et les fiches de 20 créateurs (10 crédits) coûtent 20 crédits, soit $0,10.
Articulation avec les autres endpoints TikTok
Les données de Creative Center sont agrégées par TikTok : classements, rangs et courbes. Pour le profil, les vidéos et les commentaires d’un créateur, utilisez les endpoints du guide de scraping TikTok. Pour les pays des abonnés à partir du compte public d’un créateur et la détection des fausses vues, consultez le guide des nouveaux endpoints TikTok. Les publicités diffusées sur Meta sont couvertes par les API Facebook Ad Library.
FAQ
Faut-il un compte TikTok Ads ou Creator Marketplace ?
Non. Vous vous authentifiez avec une clé API SocQ et envoyez les champs indiqués ci-dessus.
D’où vient ad_id ?
D’un résultat Top Ads : passez son id à Ad Analysis comme ad_id. De la même façon, l’id de Trending Hashtags va dans Hashtag Insights comme hashtag_id, et le creator_id de Top Videos va dans Creator Marketplace.
Quels pays puis-je interroger ?
Trending Hashtags, Hashtag Insights et Top Videos acceptent un code country à deux lettres, comme US, GB ou JP, et utilisent US par défaut. Utilisez pour Hashtag Insights le même country que celui qui vous a servi à trouver le hashtag.
Le tarif de départ d’un créateur est-il toujours présent ?
Le tarif fait partie de la fiche Creator Marketplace, et seuls les créateurs disposant d’une fiche renvoient un résultat. Comme pour les autres champs SocQ, une valeur que la source ne fournit pas est renvoyée à null.
Comment les résultats vides sont-ils facturés ?
Les endpoints facturés au résultat n’ont pas de frais de base : un appel qui ne renvoie rien ne coûte rien. Ad Analysis et Hashtag Insights sont facturés une fois par appel.
TIKTOK CREATIVE CENTER API
Tester le workflow avec une URL publique TikTok Creative Center
Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.
Découvrir les API TikTok Creative Center