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ètres | Obligatoire | Description |
|---|---|---|
room_id | Obligatoire | Identifiant 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é.
- 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.
- Envoyez l’identifiant, sous forme de chaîne non vide composée uniquement de chiffres, en POST à /v1/douyin/live-room-detail.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- 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.
API associées
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.