Rednote Note Comments
Los comentarios de una nota de Rednote son respuestas públicas asociadas a una nota específica y pueden incluir el texto de la respuesta, la identidad del autor, la hora de publicación, la referencia del hilo y los conteos visibles de interacción. Ayudan a quienes investigan a conservar lo que la gente dijo en torno a una nota elegida, manteniendo cada observación vinculada a su fuente y a su hora de recopilación.
Funcionalidades de la Rednote Note Comments API
- Entrada flexible con enlaces para compartir de RednoteEnvíe una referencia alojada en xiaohongshu.com, xhslink.com o un subdominio; el validador de note-comments no exige una ruta, una cadena de consulta ni un xsec_token concretos.
- Registros de comentarios establesReciba los ID de los comentarios, el texto, las URL de origen, las marcas de tiempo y la identidad del autor disponible con la estructura de resultado normalizada CommentItem 1.0.
- Referencias de la nota y del hiloConserva post_id y parent_id cuando se proporcionan, para que los comentarios devueltos sigan asociados a su nota y al contexto del comentario padre disponible.
- Campos de interacción en un momento dadoMantiene los likes_count y replies_count disponibles junto a collected_at, sin convertir los valores ausentes en cero ni sugerir una cobertura completa de las respuestas.
Parámetros de la Rednote Note Comments API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | Referencia obligatoria y no vacía. La validación en tiempo de ejecución acepta xiaohongshu.com, xhslink.com y sus subdominios sin imponer una ruta ni exigir xsec_token; use un enlace real para compartir la nota, para que el proveedor pueda resolver la nota deseada. |
Cómo usar la Rednote Note Comments API
Envíe un enlace de nota de Rednote compatible, siga la tarea asíncrona y lea los comentarios normalizados almacenados.
- Copie un enlace real para compartir una nota de Rednote en xiaohongshu.com o xhslink.com.
- Envíe url por POST a /v1/rednote/note-comments y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
- Lea data.results.items; siga next_cursor solo cuando has_more sea true para paginar los resultados almacenados de la tarea.
curl -X POST "https://api.socq.ai/v1/rednote/note-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://xhslink.com/{share_code}"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Rednote Note Comments API
- Codificación cualitativa de respuestas: Revise el texto público devuelto y el contexto del autor disponible para organizar preguntas, reacciones o temas de conversación recurrentes en torno a una nota seleccionada.
- Archivos de comentarios con enlace a la fuente: Conserve los ID de los comentarios, las URL de origen, post_id, parent_id, published_at y collected_at para obtener registros de investigación rastreables.
- Revisión de instantáneas de interacción: Compare los conteos disponibles de Me gusta y respuestas entre los comentarios devueltos, anclando cada observación a su hora de recopilación.
Consejos de expertos para la Rednote Note Comments API
- Use el enlace completo copiado para la nota deseada; pasar solo la validación del nombre de host no garantiza que el proveedor pueda resolver una ruta no relacionada.
- No invente ni exija por separado xsec_token. Esa regla pertenece al contrato de note-detail, no a rednote/note-comments.
- No envíe results_limit ni un cursor del proveedor: el envío solo admite url y realiza una sola solicitud a la fuente.
- Trate parent_id, post_id, las marcas de tiempo, los atributos del autor y las métricas como campos de la fuente que pueden ser nulos y no como valores garantizados.
- Mantenga la profundidad de recopilación de la fuente separada de next_cursor, que solo pagina los registros normalizados ya almacenados de una tarea completada.
APIs relacionadas
Además de la Rednote Note Comments API, use estas APIs cuando necesite otro tipo de datos públicos de Rednote.