Douyin Video Detail
Un registro de detalle de video de Douyin conecta la URL pública de un video conocido con campos normalizados de contenido, creador de contenido, contenido multimedia, tiempos e interacción visible. Resulta útil cuando un flujo de trabajo ya tiene el enlace exacto de un video y necesita un único registro consistente para enriquecimiento, revisión o comparación posterior.
Funcionalidades de la Douyin Video Detail API
- URL de Douyin compatibleAcepta una URL en douyin.com, iesdouyin.com o un subdominio compatible. Cuando aparece /video/, debe ir seguido de un ID numérico.
- Resultado acotado de un solo videoEjecuta una solicitud de detalle al proveedor y almacena como máximo un registro de video normalizado, sin paginación de origen ni results_limit.
- Contexto de la descripción y del creador de contenidoDevuelve el texto disponible del video junto con el ID normalizado del creador de contenido, el nombre de usuario, el nombre visible, la URL del perfil, el avatar y los indicadores de cuenta.
- Campos de contenido multimedia y duraciónConserva las referencias disponibles de video o imagen, las vistas previas, las dimensiones, la duración del contenido multimedia y el campo normalizado duration_seconds.
- Instantánea de interacción con marca de tiempoAsocia las cantidades disponibles de Me gusta, comentarios, veces compartido, reproducciones y vistas con published_at y collected_at, en lugar de presentarlas como contadores en vivo.
Parámetros de la Douyin Video Detail API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL obligatoria y no vacía en douyin.com, iesdouyin.com o un subdominio compatible. Si está presente /video/, debe ir seguido de un ID numérico; solo se acepta una URL por tarea. |
Cómo usar la Douyin Video Detail API
Envíe la URL de un video de Douyin compatible, siga la tarea asíncrona y lea su resultado normalizado almacenado tras el éxito.
- Defina DOUYIN_VIDEO_URL con una URL pública cuyo host sea douyin.com, iesdouyin.com o un subdominio. Un segmento /video/, cuando está presente, debe ir seguido de un ID numérico.
- Envíe por POST la cadena url a /v1/douyin/video-detail y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle; los campos del resultado no están disponibles mientras esté incompleta.
- Tras el éxito, lea data.results.items. El proveedor produce como máximo un elemento, y limit y next_cursor pertenecen al lector de resultados almacenados de SocQ.
curl -X POST "https://api.socq.ai/v1/douyin/video-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$DOUYIN_VIDEO_URL\"}"
# Poll GET /v1/tasks/{task_id}
# Read the normalized video from data.results.itemsCasos de uso de la Douyin Video Detail API
- Enriquecimiento de catálogos de videos conocidos: Agregue identidad, descripción, creador de contenido, momento de publicación, duración, contenido multimedia y campos de origen normalizados a enlaces de videos de Douyin aprobados.
- Conexión del descubrimiento con el detalle: Use como entrada exacta de una consulta de detalle puntual la URL compatible de un video conservada a partir de un registro de videos de usuario o de búsqueda de videos de Douyin.
- Preparación de comparaciones en momentos concretos: Almacene resultados exitosos repetidos con collected_at para comparar las instantáneas públicas de interacción disponibles según un calendario definido.
Consejos de expertos para la Douyin Video Detail API
- Use una referencia pública directa a un video en un nombre de host compatible para que el proveedor pueda resolverla; si contiene /video/, mantenga intacto el ID numérico del video.
- Deje vacío el campo del Playground hasta que tenga una URL pública real de un video; este endpoint no tiene un valor predeterminado universal confiable.
- Envíe una URL por tarea y omita results_limit, cursor e ID no relacionados, porque la solicitud pública acepta solo url.
- Trate los campos ausentes de creador de contenido, contenido multimedia, audio, hashtags, menciones o interacción como no disponibles, y no como cadenas vacías ni cero.
- Use collected_at para comparar métricas y published_at para la cronología del contenido; describen momentos distintos.
- Si continúa con los comentarios del video, pase una URL de video compatible disponible a ese otro endpoint, en lugar de suponer que la tarea de detalle se amplía a comentarios.
APIs relacionadas
Además de la Douyin Video Detail API, use estas APIs cuando necesite otro tipo de datos públicos de Douyin.
- Douyin Live Room Detail API — Obtiene una transmisión en vivo conocida de Douyin por ID numérico de sala, con contexto normalizado de la sala, identidad del anfitrión, contenido multimedia y conteos visibles de audiencia.
- Douyin User Profile API
- Douyin User Videos API
- Douyin Video Comments API
- Douyin Video Search API