SocQ couvrait déjà les profils, vidéos, commentaires, recherches et hashtags TikTok publics ; le guide de scraping TikTok les présente en détail. Le 2026-11-17, 14 endpoints TikTok supplémentaires ont été mis en ligne sur la page de la plateforme TikTok. Ils répondent à des questions que les endpoints de base ne pouvaient pas traiter : où vivent les abonnés d’un créateur, si les vues d’une vidéo sont réelles, ce que les gens recherchent aujourd’hui et ce qu’un LIVE vend en ce moment.
Ce guide regroupe les nouveaux endpoints par usage, montre une requête pour chacun, indique le prix et précise quand l’utiliser.
Réponse rapide : chaque endpoint est un
POSTvershttps://api.socq.ai/v1/tiktok/<endpoint>avec un corps JSON. L’appel renvoie untask_id; interrogezGET /v1/tasks/{task_id}jusqu’à ce questatusvaillesucceeded, puis lisezdata.results.items.
Les nouveaux endpoints TikTok en un coup d’œil
1 crédit SocQ = $0,005. Les endpoints facturés au résultat n’ont pas de frais de base : un résultat vide ne coûte rien.
| Endpoint | Ce qu’il renvoie | Prix |
|---|---|---|
| API TikTok Audience Demographics | Pays des abonnés avec leur part et le nombre d’abonnés échantillonnés | 20 crédits ($0,10) par appel |
| API TikTok Fake Views Checker | Score de fausses vues, fausses vues estimées et leur part, niveau de trafic, raison principale | 5 crédits ($0,025) par appel |
| API TikTok Similar Accounts | Comptes que TikTok recommande comme similaires, avec bios et compteurs | 0,5 crédit ($0,0025) par compte |
| API TikTok Reposts | Vidéos republiées par un compte, avec auteur d’origine et statistiques | 0,5 crédit ($0,0025) par vidéo |
| API TikTok Playlists | Playlists publiques avec nom, couverture et nombre de vidéos | 0,5 crédit ($0,0025) par playlist |
| API TikTok Trending Searches | Une centaine de recherches tendance du jour, classées | 0,5 crédit ($0,0025) par appel |
| API TikTok Creator Search Insights | 20 recherches populaires avec score de popularité et tendance sur sept points | 1 crédit ($0,005) par appel |
| API TikTok Hashtag Views | Total de vidéos et de vues pour jusqu’à 20 hashtags | 0,5 crédit ($0,0025) par hashtag |
| API TikTok Comment Keywords | Mots-clés des commentaires classés, avec les commentaires correspondants | 1 crédit ($0,005) par appel |
| API TikTok Sound Search | Sons avec artiste, durée, extrait et nombre d’utilisations | 0,6 crédit ($0,003) par son |
| API TikTok Photo Search | Carrousels photo avec toutes les images et l’engagement | 0,6 crédit ($0,003) par publication |
| API TikTok Live Search | LIVE en cours de diffusion, avec hôte, spectateurs et likes | 0,6 crédit ($0,003) par live |
| API TikTok Live Ranking | Jusqu’à 99 hôtes du classement LIVE quotidien, avec score basé sur les cadeaux | 0,5 crédit ($0,0025) par appel |
| API TikTok Live Shopping | Produits du panier d’un LIVE, avec prix et unités vendues | 0,1 crédit ($0,0005) par produit |
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.
Vous pouvez ajouter un callback_url facultatif à n’importe quel corps d’envoi ci-dessous. SocQ envoie alors 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.
Évaluer un créateur avant de le payer
Ces cinq endpoints vous aident à décider si un créateur vaut un partenariat.
Audience Demographics liste chaque pays d’un échantillon d’abonnés avec sa part et le nombre d’abonnés échantillonnés correspondant, du plus important au plus petit. Utilisez-le pour vérifier que l’audience d’un créateur se trouve bien sur le marché où vous vendez. username fonctionne avec ou sans @. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame"}'
Fake Views Checker prend l’URL d’une vidéo ou d’une publication photo et renvoie fake_score, is_suspicious, confidence_level, estimated_fake_views, fake_view_percentage, estimated_organic_views, traffic_tier et main_reason. Le champ facultatif category (general par défaut, ou entertainment, education, product, verified_large) choisit les références d’engagement. Lancez-le sur les publications sponsorisées et sur les créateurs que vous vous apprêtez à payer pour leur portée. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/fake-views" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
Similar Accounts renvoie les comptes que TikTok lui-même recommande comme similaires à un nom d’utilisateur, dans l’ordre de TikTok, avec bio, nombre d’abonnés et de vidéos, et statut de vérification. Quand un créateur fonctionne pour vous, cela élargit la liste restreinte autour de lui. results_limit vaut 30 par défaut (de 1 à 300). (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/similar-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame", "results_limit": 30}'
Reposts montre ce qu’un compte relaie au-delà de ses propres vidéos : chaque vidéo republiée avec son auteur d’origine, sa légende, ses vues, ses likes, ses hashtags et son fichier vidéo, de la plus récente à la plus ancienne. results_limit vaut 20 par défaut (de 1 à 500). (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "mrbeast", "results_limit": 20}'
Playlists liste les playlists publiques d’un créateur avec nom, couverture et item_count, ce qui montre les séries et les formats auxquels il revient régulièrement. results_limit vaut 20 par défaut (de 1 à 100). (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "zachking"}'
Une vérification complète d’un créateur, avec Audience Demographics, Fake Views sur trois vidéos récentes et 30 comptes similaires, coûte 20 + 15 + 15 = 50 crédits ($0,25).
Découvrir ce que les gens recherchent et commentent
Trending Searches ne prend aucune entrée et renvoie une centaine de recherches tendance du jour dans l’ordre de TikTok, chacune avec un lien de recherche. La liste est actualisée chaque jour : c’est un bon flux matinal d’idées de contenu. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/trending-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Creator Search Insights renvoie 20 recherches populaires, chacune avec un score de popularité de 0 à 100, une tendance sur sept points, le nombre de vidéos associées, une catégorie et des libellés. Tous les champs sont facultatifs : language (par défaut en ; aussi ar, de, es, fr, id, ja, ko, pt, th, tr, vi), category (fashion, food, gaming, science, sports, tourism) et filter_by. Réglez filter_by sur content_gap pour obtenir les recherches qui ont de la demande mais encore peu de vidéos. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/search-insights" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"language": "en", "category": "food", "filter_by": "content_gap"}'
Hashtag Views compare jusqu’à 20 hashtags en une requête selon le nombre total de vidéos et de vues. Les hashtags qui n’existent pas sont ignorés et ne sont pas facturés. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags": ["cooking", "booktok"]}'
Comment Keywords lit pour vous une section de commentaires très active : les mots-clés les plus fréquents, classés, chacun avec les commentaires qui le mentionnent et leurs likes. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/comment-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
Pour les termes de recherche que TikTok affiche sous une requête, consultez le guide TikTok Top Search.
Rechercher des sons et des publications photo
Sound Search cherche dans la bibliothèque de sons par titre, artiste ou ambiance et renvoie les ID des sons, l’artiste, la couverture, la durée, un extrait écoutable et metrics.videos_count. sort_by vaut relevance (par défaut), most_used ou latest ; region vaut US par défaut. Utilisez l’ID avec TikTok Song Videos, ou comparez avec les classements du guide TikTok Music Chart. results_limit vaut 20 par défaut (de 1 à 500). (docs)
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", "results_limit": 20}'
Photo Search ne renvoie que des carrousels photo, avec toutes les images du carrousel ainsi que la légende, l’auteur, les hashtags, les vues, les likes, les commentaires et les partages. results_limit vaut 20 par défaut (de 1 à 500). (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "outfit ideas", "results_limit": 20}'
Suivre TikTok LIVE et le LIVE Shopping
Live Search trouve les LIVE en cours de diffusion au moment de la requête, avec titre, hôte, spectateurs actuels, likes et heure de début. results_limit vaut 20 par défaut (de 1 à 200). (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "deals", "results_limit": 20}'
Live Shopping liste les produits du panier d’un LIVE avec titre, prix actuel, unités vendues, vendeur et image. L’id et l’author.id de chaque résultat Live Search sont le room_id et le user_id qu’il attend : appelez-le donc pendant que le LIVE est encore en cours. results_limit vaut 100 par défaut (de 1 à 500), et un LIVE sans produits n’est pas facturé. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id": "7704767945901132575", "user_id": "7153432386608251946", "results_limit": 100}'
Live Ranking ne prend aucune entrée et renvoie jusqu’à 99 hôtes du classement LIVE quotidien en cours, avec rang, score basé sur les cadeaux, nom d’utilisateur et nombre d’abonnés. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Pour vérifier si des comptes précis sont en live, utilisez l’endpoint présenté dans le guide TikTok Live Status.
Guides TikTok associés
Les publicités et les tarifs des créateurs issus de TikTok Creative Center sont traités dans le guide de l’API TikTok Creative Center, et les nouveaux endpoints TikTok Shop dans le guide de recherche produits TikTok Shop. Pour comparer SocQ à d’autres fournisseurs, lisez Les 7 meilleures API de scraping TikTok et Les alternatives à l’API TikTok.
FAQ
Suis-je facturé lorsqu’un compte n’a ni reposts ni playlists ?
Non. Les endpoints facturés au résultat n’ont pas de frais de base, et la documentation précise qu’un résultat vide n’est pas facturé.
Comment Fake Views Checker détermine-t-il ce qui est faux ?
Il compare l’engagement de la vidéo aux références du type de contenu que vous choisissez dans category et renvoie un score, les fausses vues estimées et leur part, le niveau de trafic et la raison principale. Considérez-le comme une estimation à examiner, pas comme un verdict.
D’où viennent le room_id et le user_id pour Live Shopping ?
De TikTok Live Search : l’id d’un résultat est le room_id et son author.id est le user_id. Le LIVE doit être encore en cours.
Quelle est la différence entre Trending Searches et Creator Search Insights ?
Trending Searches est la liste classée d’une centaine de recherches du jour établie par TikTok, à 0,5 crédit. Creator Search Insights renvoie 20 recherches avec un score de popularité et une tendance sur sept points, filtrables par langue, catégorie et opportunité de contenu, à 1 crédit.
TIKTOK API
Tester le workflow avec une URL publique TikTok
Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.
Découvrir les API TikTok