douyin/
live-room-detail

Récupérez une salle de live Douyin publique à partir d’un room_id numérique connu et obtenez son titre, son statut, l’identité de l’hôte, les médias, les nombres de spectateurs et de mentions J’aime visibles, ainsi que l’heure de collecte.

Douyin Live Room Detail API

Recherche d’une salle connue
Contexte de l’hôte
Instantané de l’audience
0,1 crédit par requête
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

Douyin Live Room Detail

Les salles de live Douyin sont des sessions de diffusion publiques, avec un titre, un statut courant, l’identité de l’hôte, des médias et les nombres visibles de spectateurs et de mentions J’aime. Ces champs servent à enrichir un catalogue de salles, à suivre l’état des sessions et à comparer des observations à un instant donné.

Fonctionnalités de la Douyin Live Room Detail API

  • Détail d’une salle connueTransforme un room_id numérique connu en un enregistrement live_room normalisé au plus, grâce à une seule requête source et sans pagination côté source.
  • Contexte de la salle et de l’hôteRéunit dans une même structure le titre de la salle, son statut, l’identité de l’hôte, l’URL source et l’heure de collecte, lorsqu’ils sont disponibles.
  • Instantané visible de la sessionCapture les nombres de spectateurs et de mentions J’aime disponibles ainsi que les médias publics, pour une vue horodatée de la salle.

Paramètres de la Douyin Live Room Detail API

ParamètresObligatoireDescription
room_idObligatoireIdentifiant obligatoire d’une salle de live Douyin, composé uniquement de chiffres. Envoyez-le sous forme de chaîne afin qu’un client n’arrondisse pas les identifiants longs.

Comment utiliser la Douyin Live Room Detail API

Partez d’un ID de salle numérique connu, envoyez la tâche de détail asynchrone, puis lisez son résultat normalisé stocké.

  1. Obtenez room_id dans un contexte de live qui expose l’identifiant numérique ; cet endpoint ne permet pas de découvrir des ID de salle.
  2. Envoyez l’identifiant, sous forme de chaîne non vide composée uniquement de chiffres, en POST à /v1/douyin/live-room-detail.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. Lisez data.results.items depuis /v1/tasks/{task_id}?limit=50 ; une salle résolue produit au plus un élément, et next_cursor ne concerne que la pagination des résultats stockés par SocQ.
# Set DOUYIN_ROOM_ID to a known numeric room_id before sending.
curl -X POST "https://api.socq.ai/v1/douyin/live-room-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"room_id\":\"${DOUYIN_ROOM_ID}\"}"

# Poll GET /v1/tasks/{task_id}, then read data.results.items from /v1/tasks/{task_id}?limit=50.

Cas d’usage de la Douyin Live Room Detail API

  • Enrichissement d’un catalogue de salles de live : Ajoutez titre, statut, hôte, médias, métriques visibles et heure de collecte, quand ils sont disponibles, à un catalogue qui stocke déjà l’ID de la salle.
  • Suivi d’instantanés de l’état des sessions : Conservez des enregistrements collectés séparément avec collected_at pour distinguer, à un instant donné, le statut de la salle et les observations d’audience.
  • Revue du contexte hôte et salle : Examinez l’identité disponible de l’hôte à côté du titre, du statut, des médias et des nombres de session visibles de la salle, dans un seul enregistrement normalisé.

Conseils d’expert pour la Douyin Live Room Detail API

  • Envoyez room_id sous forme de chaîne entre guillemets composée uniquement de chiffres, et non d’un nombre JavaScript, pour qu’un identifiant long garde tous ses chiffres.
  • Obtenez un room_id connu avant d’appeler l’endpoint, car la requête récupère un détail et ne réalise pas de découverte de salles de live.
  • Conservez le room_id envoyé dans votre propre enregistrement ; le résultat canonique de la salle de live ne garantit pas que la source le renvoie sous id.
  • Considérez titre, statut, auteur, métriques, médias, URL et horodatages comme nullables, car la source peut omettre certains champs publics.
  • N’envoyez ni results_limit ni curseur source ; lorsqu’il est présent, next_cursor pagine les éléments de résultat stockés par SocQ, et non la requête du fournisseur.

En complément de la Douyin Live Room Detail API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Douyin.

Explorer d’autres plateformes

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

Douyin Live Room Detail API — FAQ

Douyin Live Room Detail API récupère une salle de live publique connue à partir de son room_id numérique. Elle renvoie les champs disponibles de la salle, de l’hôte, des médias, de l’audience et de l’heure de collecte sous forme d’un enregistrement normalisé à un instant donné.

Utilisez un contexte de live public qui expose l’identifiant numérique de la salle et conservez-le avec votre enregistrement. Cet endpoint ne recherche pas de salles de live et ne permet pas de découvrir des ID de salle.

Le validateur exige une chaîne conforme au format d’ID de salle composé de chiffres. Garder la valeur sous forme de texte évite aussi que les clients numériques n’arrondissent les ID longs.

L’enregistrement normalisé peut comprendre title, status, author, URL, médias, les viewers_count et likes_count visibles, created_at et collected_at. Tout champ source facultatif peut être null ou absent.

Non. Il effectue une seule requête de détail et produit au plus un enregistrement normalisé ; le next_cursor des résultats de la tâche n’est que le curseur standard des éléments déjà stockés par SocQ.

Une tâche réussie a un coût fixe de 0,10 crédit SocQ. Ce montant ne change ni avec le nombre de résultats ni avec un réglage de pagination.