Rednote Comment Replies
Las respuestas a comentarios de Rednote son respuestas públicas anidadas bajo un comentario seleccionado de una nota, con el texto de la respuesta, el contexto del autor, marcas de tiempo y los campos de relación o interacción disponibles. Los registros normalizados ayudan a los equipos a examinar una rama de conversación conocida sin mezclar el identificador del comentario de origen con la paginación de los resultados almacenados.
Funcionalidades de la Rednote Comment Replies API
- Referencia de hilo emparejadaApunta a una rama de conversación con la URL pública de la nota y el identificador del comentario que le pertenece.
- Captura de respuestas de una sola páginaEjecuta una solicitud a la fuente y guarda las respuestas devueltas en esa página, sin exponer un cursor del proveedor ni un límite de resultados al enviar la solicitud.
- Cuerpo de respuesta normalizadoPermite leer el ID de la respuesta, el texto público, la URL de origen, la hora de publicación y la hora de recopilación con la estructura compartida CommentItem.
- Contexto público del autorMantiene junto a cada respuesta el ID del autor, el nombre de usuario, el nombre visible, la URL del perfil, el avatar y los indicadores de cuenta disponibles.
- Relaciones de la conversaciónConserva los vínculos parent_id y post_id disponibles junto con los conteos visibles de Me gusta y respuestas, para un procesamiento que respete el hilo.
Parámetros de la Rednote Comment Replies API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL pública obligatoria cuyo host sea xiaohongshu.com, xhslink.com o un subdominio de cualquiera de ellos. Este endpoint no agrega un patrón de ruta ni exige el parámetro de consulta xsec_token. |
comment_id | Obligatorio | Identificador obligatorio del comentario de origen, de 1 a 256 letras ASCII, números, dos puntos, guiones bajos o guiones. |
Cómo usar la Rednote Comment Replies API
Envíe la URL de una nota de Rednote y un ID de comentario que coincidan, y luego lea el resultado de respuestas de una página mediante el flujo de tareas asíncronas de SocQ.
- Elija una URL pública de nota de xiaohongshu.com o xhslink.com y verifique un ID de comentario compatible de esa misma nota.
- Envíe url y comment_id por POST a /v1/rednote/comment-replies y conserve el task_id devuelto.
- Consulte GET /v1/tasks/{task_id} mientras la tarea esté en cola, en ejecución o en reintento; deténgase en succeeded o failed.
- Tras el éxito, lea data.results.items y use data.results.next_cursor solo para paginar las filas de respuestas que SocQ ya almacenó.
curl -X POST "https://api.socq.ai/v1/rednote/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_NOTE_URL\",\"comment_id\":\"$REDNOTE_COMMENT_ID\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeededCasos de uso de la Rednote Comment Replies API
- Revisión de una conversación específica: Lea el texto público y las marcas de tiempo de las respuestas de una rama de comentario seleccionada, en lugar de mezclar las respuestas de toda una nota.
- Enriquecimiento del contexto de los participantes: Asocie cada respuesta con la identidad normalizada del autor, cuando esté disponible, al preparar registros para una investigación de moderación o una revisión manual.
- Mapeo de las relaciones del hilo: Use los ID de las respuestas junto con parent_id y post_id para reconectar los registros almacenados con su comentario de origen y su nota, cuando esos campos estén presentes.
- Instantáneas de respuestas en un momento dado: Conserve collected_at junto a los conteos visibles de Me gusta o respuestas para que las ejecuciones separadas sigan siendo observaciones distinguibles.
Consejos de expertos para la Rednote Comment Replies API
- Verifique que comment_id pertenezca a la URL de nota enviada; el endpoint valida el formato de cada campo, pero no establece esa relación antes de la solicitud a la fuente.
- Use una URL pública completa de xiaohongshu.com, xhslink.com o un subdominio aceptado, aunque este validador no exija una ruta de nota concreta ni el parámetro de consulta xsec_token.
- Mantenga comment_id dentro del patrón de identificador ASCII aceptado, de 1 a 256 caracteres, y no lo sustituya por un ID interno de base de datos ni por un ID de tarea de SocQ.
- Trate un ID de comentario de otra recopilación como una entrada condicional: los ID de comentario normalizados son opcionales, así que confirme que haya un valor utilizable antes de enviarlo aquí.
- No agregue results_limit ni un cursor de la fuente a la solicitud de envío; este endpoint realiza una sola solicitud al proveedor para una sola página de la fuente.
- Mantenga el next_cursor de los resultados de la tarea separado de comment_id, porque ese cursor solo pagina las filas normalizadas guardadas después de que la tarea tiene éxito.
- Admita campos nulos de identidad, relación, marca de tiempo y métricas, y aplique escape al texto público de las respuestas antes de mostrarlo en otro producto.
APIs relacionadas
Además de la Rednote Comment Replies API, use estas APIs cuando necesite otro tipo de datos públicos de Rednote.