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ámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL 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_limit | Opcional | Entero 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.
- Defina DOUYIN_VIDEO_URL con una URL pública de douyin.com o iesdouyin.com que tenga una ruta /video/{numeric_id}.
- Envíe por POST url y el results_limit opcional a /v1/douyin/video-comments y guarde el task_id.
- Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
- 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 trueCasos 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.
APIs relacionadas
Además de la Douyin Video Comments 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 Detail API
- Douyin Video Search API