douyin/
video-comments

Recopile una página de comentarios públicos a partir de la URL directa de un video de Douyin y obtenga texto, autor, relación, momento y campos visibles de interacción normalizados.

Douyin Video Comments API

URL directa del video
Una página de origen
CommentItem 1.0
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 Comments

Los comentarios de videos de Douyin son respuestas públicas asociadas a un video, con texto, identidad del autor, contexto de publicación y señales visibles de Me gusta o de respuestas. Estos registros sirven para revisar la respuesta de la audiencia, mapear conversaciones y comparar la interacción en momentos concretos.

Funcionalidades de la Douyin Video Comments API

  • Selección directa del videoResuelve el ID numérico del video a partir de una URL pública de douyin.com o iesdouyin.com cuya ruta contenga /video/{numeric_id}.
  • Recopilación acotada de una sola páginaSolicita hasta 20 filas de comentarios de la primera página de la fuente, y results_limit controla el subconjunto almacenado, de 1 a 20.
  • Contexto canónico del comentarioDevuelve registros CommentItem 1.0 con texto, identidad del autor, relaciones con el video y con el comentario superior, momentos de publicación y de recopilación, y cantidades visibles de Me gusta o de respuestas.

Parámetros de la Douyin Video Comments API

ParámetrosObligatorioDescripción
urlObligatorioURL pública obligatoria en douyin.com, iesdouyin.com o un subdominio. Su ruta debe contener /video/ seguido de un ID numérico de video.
results_limitOpcionalEntero opcional de 1 a 20. Si se omite, el valor predeterminado es 20; la integración solicita solo la primera página de la fuente.

Cómo usar la Douyin Video Comments API

Defina la URL pública directa de un video de Douyin, envíe la tarea asíncrona y lea los comentarios normalizados almacenados para esa tarea.

  1. Defina DOUYIN_VIDEO_URL con una URL pública de douyin.com o iesdouyin.com que tenga una ruta /video/{numeric_id}.
  2. Envíe por POST url y el results_limit opcional a /v1/douyin/video-comments y guarde el task_id.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
  4. Lea data.results.items y siga next_cursor solo mientras has_more sea true para continuar con los registros que SocQ ya almacenó.
curl -X POST "https://api.socq.ai/v1/douyin/video-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"${DOUYIN_VIDEO_URL}\",\"results_limit\":20}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Douyin Video Comments API

  • Revisión de la respuesta de la audiencia: Use el texto de los comentarios, la identidad del autor y las cantidades visibles de Me gusta o de respuestas para revisar las reacciones a un video público conocido.
  • Mapeo de relaciones entre comentarios: Conecte los comentarios devueltos con el video de origen y con cualquier referencia superior indicada mediante post_id y parent_id.
  • Comparación de instantáneas de interacción: Compare las señales visibles de los comentarios entre videos seleccionados o momentos de recopilación, conservando collected_at como marca de tiempo de la observación.

Consejos de expertos para la Douyin Video Comments API

  • Resuelva un enlace compartido o redirigido hasta su URL final /video/{numeric_id} aceptada antes de enviarla, para que la validación del host y de la ruta tenga éxito.
  • Omita results_limit para solicitar 20 filas, o elija un entero menor cuando solo necesite un subconjunto de la única página de la fuente devuelta.
  • Reutilice el task_id original y siga next_cursor solo cuando has_more sea true; ese cursor lee filas almacenadas y no obtiene otra página de la fuente.
  • Use el id del comentario como clave principal de deduplicación y permita que parent_id o post_id queden en null cuando la fila de la fuente omita una relación.
  • Trate los datos del autor, published_at y las métricas individuales como opcionales, y use collected_at para marcar la hora de cada instantánea de resultados.
  • Escape el texto de los comentarios antes de insertarlo en HTML, porque los comentarios públicos son contenido generado por usuarios.

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

Douyin Video Comments API recopila una página de comentarios públicos a partir de la URL de un video de Douyin con una ruta de video numérica, y devuelve texto, autor, relación, momento y cantidades visibles de Me gusta o de respuestas, todo normalizado.

La url debe usar douyin.com, iesdouyin.com o un subdominio, y su ruta debe contener /video/ seguido de un ID numérico. Las rutas de perfiles, de búsqueda y las que no son de video se rechazan.

results_limit acepta enteros de 1 a 20 y su valor predeterminado es 20. La tarea solicita una sola página de la fuente, por lo que no puede continuar en páginas adicionales de la fuente.

CommentItem 1.0 incluye los campos base de identidad y momento, además de text, author, parent_id, post_id y metrics con likes_count y replies_count. Los campos opcionales de la fuente quedan en null cuando no están disponibles.

No hace una solicitud aparte de páginas de respuestas. Una fila devuelta puede exponer replies_count y un parent_id cuando la fuente los proporciona, pero esos campos no implican que se haya recopilado el texto de las respuestas.

next_cursor pertenece a GET /v1/tasks/{task_id} y pagina los registros que SocQ ya almacenó tras el éxito. Nunca solicita la siguiente página de la fuente de Douyin.

Cada tarea exitosa cuesta un valor fijo de 0.10 créditos de SocQ, independientemente de results_limit o de la cantidad de elementos devueltos; las tareas fallidas siguen la vía de reembolso del entorno de ejecución.