Douyin Live Room Detail
Las salas de transmisión en vivo de Douyin son sesiones públicas con un título, un estado actual, la identidad del anfitrión, contenido multimedia y las cantidades visibles de espectadores y de Me gusta. Estos campos sirven para enriquecer catálogos de salas, hacer seguimiento del estado de las sesiones y comparar en momentos concretos.
Funcionalidades de la Douyin Live Room Detail API
- Consulta de detalle de una sala conocidaConvierte un room_id numérico conocido en, como máximo, un registro live_room normalizado mediante una sola solicitud a la fuente, sin paginación de origen.
- Contexto de la sala y del anfitriónMantiene juntos, en una forma consistente, el título de la sala, el estado, la identidad del anfitrión, la URL de origen y el momento de recopilación disponibles.
- Instantánea visible de la sesiónCaptura las cantidades disponibles de espectadores y de Me gusta junto con el contenido multimedia público, para tener una vista de la sala con marca de tiempo.
Parámetros de la Douyin Live Room Detail API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
room_id | Obligatorio | Identificador obligatorio de la sala de transmisión en vivo de Douyin, compuesto solo por dígitos. Envíelo como cadena para que un cliente no redondee los identificadores largos. |
Cómo usar la Douyin Live Room Detail API
Comience con un ID de sala numérico conocido, envíe la tarea de detalle asíncrona y lea después su resultado normalizado almacenado.
- Obtenga el room_id de un contexto de transmisión en vivo que exponga el identificador numérico; este endpoint no descubre ID de salas.
- Envíe por POST el identificador como una cadena no vacía compuesta solo por dígitos a /v1/douyin/live-room-detail.
- Consulte /v1/tasks/{task_id} hasta que status sea succeeded o failed.
- Lea data.results.items desde /v1/tasks/{task_id}?limit=50; una sala resuelta produce como máximo un elemento, y next_cursor pertenece solo a la paginación de los resultados almacenados de 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.Casos de uso de la Douyin Live Room Detail API
- Enriquecimiento de catálogos de salas en vivo: Agregue el título, el estado, el anfitrión, el contenido multimedia, las métricas visibles y el momento de recopilación disponibles a un catálogo que ya almacena el ID de la sala.
- Seguimiento de instantáneas del estado de la sesión: Conserve registros recopilados por separado con collected_at para distinguir observaciones del estado de la sala y de la audiencia en momentos concretos.
- Revisión del contexto anfitrión y sala: Revise la identidad disponible del anfitrión junto con el título de la sala, el estado, el contenido multimedia y las cantidades visibles de la sesión en un único registro normalizado.
Consejos de expertos para la Douyin Live Room Detail API
- Envíe room_id como una cadena entrecomillada compuesta solo por dígitos y no como un número de JavaScript, para que un identificador largo conserve todos sus dígitos.
- Obtenga un room_id conocido antes de llamar al endpoint, porque la solicitud recupera detalles y no descubre salas de transmisión en vivo.
- Conserve el room_id enviado en su propio registro; el resultado canónico de la sala no garantiza que la fuente lo devuelva como id.
- Trate title, status, author, metrics, media, la URL y las marcas de tiempo como valores que pueden ser nulos, porque la fuente puede omitir campos públicos individuales.
- No envíe results_limit ni un cursor de la fuente; next_cursor, cuando está presente, pagina los elementos de resultado almacenados de SocQ y no la solicitud al proveedor.
APIs relacionadas
Además de la Douyin Live Room Detail API, use estas APIs cuando necesite otro tipo de datos públicos de Douyin.