rednote/
note-detail

Obtenga una nota pública de Rednote a partir de una URL de xiaohongshu.com o xhslink.com con token, con texto, autor, contenido multimedia, marcas de tiempo e interacción visible, todo normalizado.

Rednote Note Detail API

URL de nota con token
Detalle de una sola nota
Registro de publicación normalizado
1 crédito 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

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ámetrosObligatorioDescripción
urlObligatorioURL 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.

  1. 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.
  2. Envíe la url por POST a /v1/rednote/note-detail y guarde data.task_id de la respuesta del envío.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
  4. 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.items

Casos 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.

Explorar otras plataformas

Combine los datos de Rednote con datos públicos de otras plataformas sociales compatibles.

Rednote Note Detail API — FAQ

Rednote Note Detail API obtiene una nota pública de Rednote a partir de una URL con token de un host aceptado y devuelve la identidad normalizada de la nota, el texto, el autor, el contenido multimedia, las referencias de temas, las marcas de tiempo y los campos de interacción visibles.

Use una URL no vacía de xiaohongshu.com, xhslink.com o un subdominio. Su ruta debe contener /explore/{note_id} o /discovery/item/{note_id}, y su consulta debe incluir un xsec_token no vacío.

No. El esquema de la solicitud pública acepta solo url; SocQ extrae note_id y xsec_token de esa URL.

Envíe la URL vigente de una nota pública que ya incluya xsec_token. Una URL devuelta por otro endpoint de notas de Rednote de SocQ es reutilizable solo si ese parámetro de consulta sigue presente; Note Detail no crea un token ausente.

El registro de publicación normalizado puede incluir la identidad de la nota, la URL, el texto, las horas de publicación y de recopilación, los detalles del autor, el contenido multimedia, los hashtags, las menciones y los conteos visibles de Me gusta, comentarios, veces compartido y vistas. Los campos públicos opcionales pueden ser nulos.

No. La fuente realiza una única búsqueda de detalle y guarda como máximo un registro. El lector compartido de tareas igualmente expone limit, next_cursor y has_more para los registros almacenados en SocQ.

El endpoint está configurado con un monto fijo de 1.00 créditos de SocQ por tarea. La estimación no varía con la cantidad de registros devueltos.