douyin/
video-detail

Convierta la URL de un video conocido de Douyin en un registro normalizado con la identidad del video, la descripción, el contexto del creador de contenido, el contenido multimedia, la duración, las marcas de tiempo y los campos visibles de interacción cuando están disponibles.

Douyin Video Detail API

URL de Douyin compatible
Un video normalizado
0.10 créditos por tarea
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 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ámetrosObligatorioDescripción
urlObligatorioURL 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.

  1. 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.
  2. Envíe por POST la cadena url a /v1/douyin/video-detail y guarde el task_id devuelto.
  3. 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.
  4. 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.items

Casos 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.

Además de la Douyin Video 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 Video Detail API — FAQ

Douyin Video Detail API obtiene un video público de Douyin a partir de una URL compatible y devuelve un registro reel-video normalizado con los campos disponibles de identidad, descripción, creador de contenido, contenido multimedia, duración, marcas de tiempo e interacción visible.

Use una URL cuyo nombre de host sea douyin.com, iesdouyin.com o un subdominio. Si la URL contiene /video/, el identificador que sigue debe ser numérico.

Use una referencia pública directa al video siempre que sea posible. El validador de entrada acepta los hosts de Douyin compatibles y comprueba un ID numérico siempre que aparece /video/, pero el proveedor aún necesita una referencia de video que se pueda resolver para devolver datos.

El esquema reel-video puede contener campos base de identidad y tiempos, texto de la descripción, contexto del creador de contenido, contenido multimedia, hashtags, menciones, shortcode, duración, audio y las cantidades disponibles de Me gusta, comentarios, veces compartido, reproducciones y vistas. Los campos opcionales pueden ser null.

No. El proveedor realiza una sola solicitud de detalle y puede almacenar como máximo un elemento. limit, has_more y next_cursor forman parte del lector compartido de resultados de tareas de SocQ, no de una paginación del proveedor.

El POST devuelve un task_id. Consulte /v1/tasks/{task_id}; data.results aparece cuando la tarea se completa con éxito, y se rechaza un cursor mientras la tarea esté incompleta.

Cada tarea exitosa tiene un cargo fijo de 0.10 créditos de SocQ. El cargo no escala con la cantidad de resultados, porque se trata de una tarea fija de un solo detalle.