API Douyin

Qu’est-ce que l’API Douyin ?

L’API Douyin de TikHub est une interface RESTful qui renvoie du JSON structuré pour les contenus publics de 抖音 — l’application chinoise de vidéo courte de ByteDance, une plateforme distincte de TikTok, avec ses propres contenus, comptes et infrastructures. Vous demandez une vidéo, un profil, un fil de commentaires, une recherche, un classement ou une fiche Xingtu et vous recevez des données propres et typées.

Elle couvre six séries, dont des surfaces propres à Douyin — classements de contenus populaires et place de marché créateurs Xingtu — sans équivalent TikTok. Pour quiconque mène des travaux de recherche, de trading ou de veille marketing touchant à l’internet chinois, c’est la couche de données de la plus grande plateforme du pays.

Comment y accéder et l’utiliser ?

Créez un compte TikHub, générez une clé API et effectuez une requête HTTP GET avec la clé dans l’en-tête Authorization. Identifiez le contenu par aweme_id (l’identifiant vidéo de Douyin), par sec_uid d’un utilisateur, par URL de partage ou par terme de recherche, et vous recevez du JSON. Il n’y a ni inscription développeur chinoise, ni demande auprès de la plateforme ouverte 抖音, ni OAuth.

Quels langages de programmation sont pris en charge ?

Tout langage capable de parler HTTP — Python, JavaScript/TypeScript, Go, Java, PHP et d’autres — ainsi que les outils no-code. Python est courant pour les pipelines de données sur le marché chinois, avec un SDK officiel disponible, mais l’API est indépendante du langage ; la forme de la requête est identique d’une stack à l’autre.

Pourquoi va-t-elle plus loin qu’une collecte générique de vidéo courte ?

La plupart des fournisseurs soit ne couvrent pas Douyin, soit s’arrêtent aux données de base des vidéos et des profils. TikHub ajoute les surfaces qui comptent vraiment pour la veille sur la Chine : la série Billboard avec les classements de contenus populaires et par catégorie, la série Xingtu avec les données officielles de la place de marché créateurs pour qualifier les KOL, les listings e-commerce complets, les commentaires danmaku et une recherche dédiée sur les vidéos, les utilisateurs, les musiques et les lives.

Cette étendue fait la différence entre observer Douyin et le lire — entre savoir qu’une vidéo est devenue virale et comprendre quel classement elle a gravi, quel niveau de créateur l’a produite et comment l’audience a réagi instant par instant.

Quel temps fait-elle gagner ?

Douyin est plus difficile d’accès que la plupart des plateformes occidentales — réponses en chinois, mesures anti-bot agressives et schémas de signature changeants. Construire et maintenir cela soi-même représente un effort important et continu. TikHub l’absorbe et expose un contrat stable : une équipe peut lire les données sociales chinoises en un après-midi plutôt qu’en un trimestre, et continuer à les lire sans charge de maintenance dédiée.

Qui en profite — analystes, marques ou équipes IA ?

Les analystes du marché chinois détectent les tendances de consommation des semaines avant leur apparition en Occident. Les marques qualifient et réservent des créateurs grâce aux données Xingtu et surveillent leurs concurrents sur l’e-commerce Douyin. Les équipes IA construisent des corpus en chinois et des modèles de prédiction de tendances à partir d’une source structurée. Pour ces trois publics, les classements et les données de place de marché propres à Douyin sont des signaux qu’une extraction générique ne peut pas fournir.

Quelles données sont disponibles, et lesquelles ne le sont pas ?

L’API renvoie les données 抖音 publiquement accessibles — vidéos, profils, commentaires, recherche, classements, fiches de la place de marché Xingtu, salons de live et listings e-commerce. Les comptes privés, les messages privés et les analyses non publiques ne sont pas accessibles, et l’API est en lecture seule : ni publication, ni commentaire, ni abonnement. Les endpoints de salon de live ne renvoient de données que pendant la diffusion.

Y a-t-il des contraintes de droits d’auteur ou de téléchargement ?

Certaines URL de lecture Douyin sont soumises à des restrictions de droits d’auteur. Utilisez l’endpoint vidéo unitaire de la série App V3, qui renvoie du contenu exempt de ces restrictions, ainsi que les endpoints dédiés d’URL de lecture en haute qualité pour obtenir le meilleur flux. Les liens de téléchargement sont limités dans le temps — récupérez à nouveau la vidéo si l’un d’eux cesse de fonctionner — et des restrictions régionales peuvent exiger un proxy, comme sur TikTok.

Y a-t-il des limites de débit ?

La valeur par défaut est de 10 requêtes par seconde, extensible avec les forfaits RPS. Les endpoints de commentaires, de recherche et de listes sont paginés par curseur et renvoient des pages bornées ; continuez à suivre le curseur pour en obtenir davantage. Privilégiez les endpoints App V3 pour la stabilité et ne basculez sur la série Web qu’en cas de besoin.

Comment l’utiliser pour l’étude du marché chinois ?

Les analystes utilisent la recherche, les classements et les données de tendances pour lire le comportement des consommateurs chinois à la source — ce qui monte, quels créateurs le portent et comment cela varie selon les catégories. Comme les tendances Douyin précèdent souvent les tendances occidentales, c’est un système d’alerte précoce pour les marques et les investisseurs qui observent le marché domestique de ByteDance.

Comment l’utiliser pour la veille influence et e-commerce ?

Les données de la place de marché Xingtu permettent aux marques de qualifier des créateurs avec de vrais signaux de performance et de prix avant de lancer une campagne, tandis que les listings e-commerce et de type boutique soutiennent la surveillance concurrentielle des produits et des vendeurs. Ensemble, ils font de Douyin une source de veille sur tout l’entonnoir, de la découverte de créateurs au suivi commercial.

Comment alimente-t-elle l’IA et les modèles de tendances ?

Les données structurées en chinois — vidéos, légendes, commentaires et danmaku — alimentent corpus d’entraînement, pipelines de sentiment et modèles de prédiction de tendances. Les classements et la recherche en temps réel donnent aux agents une lecture en direct de l’internet chinois. Le flux danmaku, en particulier, permet une modélisation de l’engagement à l’échelle de l’instant que les métriques agrégées ne peuvent pas restituer.

Quels autres outils de données Douyin existent ?

La plateforme ouverte officielle de Douyin existe, mais elle exige une immatriculation d’entreprise chinoise et une validation, et n’expose qu’une tranche étroite et encadrée. Quelques outils Douyin open source existent (souvent des projets en chinois), mais avec la charge habituelle de fiabilité et de maintenance face à une plateforme difficile à collecter. Très peu de fournisseurs de données occidentaux couvrent Douyin en profondeur.

Quelle option convient à quel besoin ?

Si vous disposez d’une entité commerciale chinoise et n’avez besoin que de la tranche encadrée de la plateforme ouverte, cette voie existe. Pour tous les autres — en particulier les équipes non chinoises qui ont besoin d’une vraie profondeur, classements et Xingtu compris — une API managée comme TikHub est le choix pratique : la couverture Douyin la plus profonde accessible hors du chinois, une seule clé, aucune inscription chinoise, et la même clé fonctionne sur TikTok et 14 autres plateformes.