Retour aux API
Données publiques Douyin

Douyin Public Data APIs

Récupérez des profils et des vidéos publics, recherchez des vidéos, collectez une page de commentaires ou de vidéos d’un créateur et consultez un live connu.

API Douyin disponibles

Choisissez parmi six API pour les workflows de profils, vidéos, commentaires, recherche et lives.

Quelles données Douyin pouvez-vous récupérer ?

Le catalogue Douyin renvoie des enregistrements normalisés de comptes, de vidéos, de commentaires et de lives issus de données sources publiques.

Profils et vidéos de créateurs

Résolvez un profil public ou collectez une page source de vidéos à partir d’une URL de profil prise en charge ou d’un user_id.

Détails de vidéos, recherche et commentaires

Consultez une référence de vidéo prise en charge, recherchez par requête dans la première page source fixe ou collectez une page de commentaires.

Détails d’un live

Récupérez un live connu à partir d’un room_id composé uniquement de chiffres, avec l’hôte, le statut, les médias et l’audience visible lorsqu’ils sont disponibles.

Les spécifications des API Douyin en un coup d’œil

Chaque endpoint repose sur une requête source bornée et rejette les paramètres non déclarés.

Groupe d’APIEntrée de départLimite de la source
Profil et vidéos du créateururl ou user_idUn profil ou une page source ; les vidéos du créateur acceptent results_limit de 1–20
Détail de vidéo et commentairesURL prise en chargeUn enregistrement de détail ou une page de commentaires ; les commentaires acceptent results_limit de 1–20
Recherche de vidéosquery non videPremière page source fixe, sans results_limit
Liveroom_id composé uniquement de chiffresAu plus un enregistrement de live

Fonctionnement des API Douyin

Les six endpoints suivent le même workflow asynchrone : envoi, interrogation, lecture des résultats stockés.

  1. 1. Choisir l’endpoint

    Sélectionnez l’endpoint de profil, de vidéo, de commentaires, de recherche ou de live qui correspond à la référence publique dont vous disposez.

  2. 2. Envoyer une entrée valide

    Envoyez en POST uniquement les champs déclarés et conservez le task_id renvoyé.

  3. 3. Lire les résultats normalisés

    Interrogez la tâche jusqu’à un état final, puis lisez data.results.items et n’utilisez next_cursor que pour paginer les résultats stockés.

Rechercher des vidéos Douyin publiques

Authentifiez-vous avec une clé API SocQ et envoyez une requête non vide. Une tâche Douyin réussie coûte un montant fixe de 0,10 crédit.

curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"artificial intelligence"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Cas d’usage courants des API Douyin

Étude de créateurs

Combinez l’identité d’un profil public avec une page bornée de vidéos du créateur et l’engagement visible.

Revue de contenus et de conversations

Enrichissez des vidéos connues, obtenez un instantané d’un sujet par recherche et examinez une page de commentaires publics.

Suivi de lives

Enregistrez un instantané d’un live public connu à l’aide d’un identifiant de live numérique explicite.

Limites et politique sur les données publiques

Ces endpoints lisent des données publiques via des requêtes sources bornées et ne proposent ni actions sur les comptes ni surveillance continue.

  • user_id accepte 1–256 lettres ASCII, chiffres, deux-points, tirets bas ou traits d’union ; les URL de profil doivent contenir /user/{identifier} sur un hôte Douyin pris en charge.
  • room_id est une chaîne composée uniquement de chiffres ; ne stockez pas les identifiants longs dans des valeurs numériques JavaScript.
  • results_limit n’est disponible que pour User Videos et Video Comments, avec une plage de 1–20 et une valeur par défaut de 20.
  • Video Search est fixé à la première page source ; les curseurs de résultats de tâche ne paginent que les enregistrements déjà stockés pour cette tâche.
  • Chaque tâche Douyin réussie coûte un montant fixe de 0,10 crédit.

Questions fréquentes sur les API Douyin

Que sont les API Douyin ?

Les API Douyin récupèrent sous forme d’enregistrements normalisés les profils, vidéos, commentaires, résultats de recherche de vidéos et détails de lives publics.

Quels endpoints acceptent results_limit ?

User Videos et Video Comments acceptent un entier de 1 à 20. Les autres endpoints Douyin rejettent results_limit.

Puis-je paginer la source ?

Non. Aucun curseur de source n’est contrôlable par l’appelant. Un next_cursor renvoyé ne pagine que les résultats déjà stockés pour la tâche terminée.

Comment les requêtes Douyin sont-elles tarifées ?

Chaque tâche réussie coûte un montant fixe de 0,10 crédit SocQ.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.

YouTube API

Collectez les profils de chaînes YouTube publics pris en charge, les détails de vidéos, les vidéos de chaînes, les commentaires, les Shorts, les résultats par mot-clé et par hashtag, ainsi que les transcriptions disponibles, dans un seul flux asynchrone normalisé.

Facebook API

Collectez des profils de Pages Facebook publiques, des publications, des publications de groupes, des commentaires, des événements correspondant à un mot-clé et les transcriptions vidéo disponibles, avec des champs normalisés d’identité, de contenu, de source, de format, de lieu, de médias, de réactions, de participation et d’engagement.

X API

Collectez des profils publics, les relations d’abonnés et d’abonnements, des posts, des réponses, des citations, les comptes qui ont reposté, des résultats de recherche et les tendances actuelles. Des résultats homogènes pour vos recherches et votre veille.

LinkedIn API

Récupérez des données LinkedIn publiques de profils, d’entreprises, de publications et d’offres d’emploi à partir d’URL connues, avec des champs normalisés d’identité, de carrière, d’entreprise, de contenu, d’engagement et d’offre.

Reddit API

Récupérez les publications et commentaires Reddit publics à partir d’URL connues, parcourez les publications récentes, les mieux notées ou tendance d’un subreddit, ou recherchez des discussions par mot-clé et par période de publication.

Pinterest API

Récupérez les données de profils Pinterest publics, résolvez des Pins connus, collectez les Pins de profils sélectionnés ou lancez une recherche par mot-clé pour étudier les créateurs, les contenus et les tendances visuelles.