Rednote Note Detail
Las notas de Rednote son objetos de contenido público que combinan texto y contenido multimedia con la identidad del autor, referencias de temas, la hora de publicación y la interacción visible. Estos campos sirven para enriquecer enlaces conocidos, revisar contenido y comparar notas seleccionadas en un momento dado.
Funcionalidades de la Rednote Note Detail API
- Búsqueda de notas con tokenResuelve la URL de una nota pública conocida solo cuando su host aceptado, la ruta de detalle de nota y un xsec_token no vacío identifican una búsqueda completa en la fuente.
- Contexto de la nota y del autorDevuelve la identidad normalizada de la nota, la URL de origen, el texto, las marcas de tiempo y el ID, el nombre de usuario, el nombre visible, la URL del perfil, el avatar y los indicadores de cuenta del autor que estén disponibles.
- Instantánea de contenido multimedia e interacciónMantiene con la hora de recopilación las referencias multimedia, las vistas previas, las dimensiones, la duración, las referencias de temas y los conteos visibles de Me gusta, comentarios, veces compartido y vistas que estén disponibles.
Parámetros de la Rednote Note Detail API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL obligatoria y no vacía de xiaohongshu.com, xhslink.com o un subdominio. Su ruta debe incluir /explore/{note_id} o /discovery/item/{note_id}, y su consulta debe contener un xsec_token no vacío. |
Cómo usar la Rednote Note Detail API
Proporcione la URL vigente de una nota con token, envíe la solicitud asíncrona y lea el registro de publicación normalizado al terminar.
- Copie la URL vigente de una nota pública cuyo host aceptado, ruta de detalle de nota y cadena de consulta incluyan un xsec_token no vacío.
- Envíe la url por POST a /v1/rednote/note-detail y guarde data.task_id de la respuesta del envío.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
- Lea data.results.items tras el éxito. La búsqueda en la fuente es una única solicitud de detalle; next_cursor solo pagina los registros almacenados en SocQ.
REDNOTE_NOTE_URL=''
# Paste a current public note URL with xsec_token between the quotes
curl -X POST "https://api.socq.ai/v1/rednote/note-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_NOTE_URL\"}"
# Poll GET /v1/tasks/{task_id}
# Read the normalized post from data.results.itemsCasos de uso de la Rednote Note Detail API
- Enriquecer un catálogo de notas conocidas: Convierta la URL de una nota válida en identidad, texto, autor, hora de publicación y campos de origen normalizados para un índice de contenido existente.
- Revisar el contenido de notas seleccionadas: Use el texto, el contexto del autor, las referencias multimedia y los campos de temas para examinar un conjunto definido de notas públicas individuales.
- Comparar observaciones de interacción: Combine los conteos visibles de Me gusta, comentarios, veces compartido y vistas con collected_at en búsquedas enviadas por separado, para comparar momentos distintos.
Consejos de expertos para la Rednote Note Detail API
- Use la URL completa de la nota, con su host, la ruta /explore/ o /discovery/item/ y el parámetro de consulta xsec_token; un ID de nota por sí solo no pasa la validación.
- Mantenga xsec_token dentro de la consulta de la URL, porque la solicitud acepta solo url y rechaza un campo de token independiente.
- Al reutilizar una URL de otro resultado de notas de Rednote de SocQ, confirme que xsec_token siga presente; Note Detail no puede reconstruir un token ausente.
- Envíe una URL por tarea, porque este endpoint de detalle no tiene campo de lote, results_limit ni entrada de cursor de la fuente.
- Trate next_cursor solo como paginación de resultados almacenados; la fuente realiza una única búsqueda de detalle y normalmente produce como máximo un registro.
- Almacene de forma defensiva los campos de autor, contenido multimedia, temas, marcas de tiempo e interacción, y combine los contadores visibles con collected_at, porque los valores públicos opcionales pueden faltar.
APIs relacionadas
Además de la Rednote Note Detail API, use estas APIs cuando necesite otro tipo de datos públicos de Rednote.