douyin/
live-room-detail

Obtenga una sala de transmisión en vivo pública de Douyin a partir de un room_id numérico conocido, con su título, estado, identidad del anfitrión, contenido multimedia, cantidades visibles de espectadores y de Me gusta, y el momento de recopilación.

Douyin Live Room Detail API

Consulta de sala conocida
Contexto del anfitrión
Instantánea de audiencia
0.1 créditos por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
room_idObligatorioIdentificador 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.

  1. 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.
  2. Envíe por POST el identificador como una cadena no vacía compuesta solo por dígitos a /v1/douyin/live-room-detail.
  3. Consulte /v1/tasks/{task_id} hasta que status sea succeeded o failed.
  4. 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.

Además de la Douyin Live Room Detail API, use estas APIs cuando necesite otro tipo de datos públicos de Douyin.

Explorar otras plataformas

Combine los datos de Douyin con datos públicos de otras plataformas sociales compatibles.

Douyin Live Room Detail API — FAQ

Douyin Live Room Detail API obtiene una sala de transmisión en vivo pública conocida a partir de su room_id numérico. Devuelve los campos disponibles de sala, anfitrión, contenido multimedia, audiencia y momento de recopilación como un registro normalizado en un momento dado.

Use un contexto público de transmisión en vivo que exponga el identificador numérico de la sala y consérvelo junto con su registro. Este endpoint no busca salas de transmisión en vivo ni descubre ID de salas.

El validador del entorno de ejecución exige una cadena que cumpla el formato de ID de sala compuesto solo por dígitos. Mantener el valor como texto también evita que los clientes numéricos redondeen los ID largos.

El registro normalizado puede incluir title, status, author, URL, media, los valores visibles viewers_count y likes_count, created_at y collected_at. Cualquier campo opcional de la fuente puede ser null o estar ausente.

No. Realiza una sola solicitud de detalle y produce como máximo un registro normalizado; el next_cursor de los resultados de la tarea es solo el cursor estándar para los elementos de SocQ ya almacenados.

Una tarea exitosa tiene un costo fijo de 0.10 créditos de SocQ. El cargo no cambia con la cantidad de resultados ni con la configuración de paginación.