rednote/
user-notes

Recopile una página de notas públicas de Rednote a partir de una URL de usuario compatible o un ID de usuario, con texto, autores, contenido multimedia, marcas de tiempo e interacción visible, todo normalizado.

Rednote User Notes API

URL de usuario o ID de usuario
Una página de la fuente
Notas públicas normalizadas
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 User Notes

Las notas de usuario de Rednote son publicaciones públicas de una cuenta, con texto, atribución del autor, contenido multimedia, hora de publicación y conteos visibles de interacción. Estos campos de contenido y contexto sirven para investigar cuentas, revisar patrones de publicación, comparar formatos y analizar el rendimiento en un momento dado.

Funcionalidades de la Rednote User Notes API

  • Dos entradas de identidad de cuenta con prioridad definidaAcepta una referencia de usuario de Rednote compatible o user_id, y usa el user_id explícito cuando se proporcionan ambos campos.
  • Recopilación de notas de una cuenta en una páginaObtiene las notas públicas devueltas por una solicitud a la fuente para la cuenta seleccionada, sin exponer un cursor de la fuente ni un límite de resultados definido por quien llama.
  • Contexto normalizado de la nota y del autorDevuelve los ID de las notas, las URL públicas, el texto, la identidad del autor, las referencias multimedia, la hora de publicación y la hora de recopilación con una estructura PostItem uniforme.
  • Instantáneas de interacción visibleConserva los conteos disponibles de Me gusta, comentarios, veces compartido y vistas junto con collected_at, para comparaciones acotadas en el tiempo.

Parámetros de la Rednote User Notes API

ParámetrosObligatorioDescripción
urlObligatorio (al menos uno)Referencia de usuario de Rednote no vacía cuyo nombre de host analizado sea xiaohongshu.com, xhslink.com o un subdominio de cualquiera de los dos. No se exige un patrón de ruta; cuando la URL contiene /user/<identifier> y user_id está en blanco, se usa ese identificador; de lo contrario, la URL aceptada sigue siendo la referencia de la cuenta.
user_idObligatorio (al menos uno)Identificador de usuario de Rednote de 1 a 256 letras ASCII, números, dos puntos, guiones bajos o guiones. Indique url o user_id; cuando están presentes ambos, el user_id explícito tiene prioridad.

Cómo usar la Rednote User Notes API

Envíe una identidad de cuenta de Rednote compatible, siga la tarea asíncrona y luego pagine sus registros de notas normalizados almacenados.

  1. Prepare una URL de usuario de Rednote no vacía de un host aceptado o un user_id válido; deje en blanco el otro campo cuando no lo necesite.
  2. Envíe url o user_id por POST a /v1/rednote/user-notes y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
  4. Lea data.results.items y siga next_cursor mientras has_more sea true; este cursor pagina los registros almacenados, no páginas adicionales de la fuente de Rednote.
curl -X POST "https://api.socq.ai/v1/rednote/user-notes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$REDNOTE_USER_URL\"}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Rednote User Notes API

  • Inventario de publicaciones de una cuenta pública: Use los ID de las notas, las URL públicas, el texto, la atribución del autor y la hora de publicación para catalogar la instantánea devuelta de la cuenta.
  • Revisión de formatos de contenido: Compare las referencias disponibles de imágenes y videos, las dimensiones, las miniaturas y el texto de las notas devueltas de la cuenta.
  • Análisis de patrones de publicación: Ordene las notas por published_at y examine el texto y el contenido multimedia en conjunto para revisar la mezcla de publicación visible de la cuenta dentro de la instantánea.
  • Comparación de interacción en un momento dado: Compare los Me gusta, comentarios, veces compartido y vistas visibles, usando collected_at para mantener cada observación ligada a su momento de recopilación.

Consejos de expertos para la Rednote User Notes API

  • Use un user_id estable cuando ya lo tenga; tiene prioridad sobre url y evita la ambigüedad entre dos referencias de cuenta.
  • Al enviar url, valide que su nombre de host sea xiaohongshu.com o xhslink.com; no se exige un patrón de ruta específico.
  • Si una URL compatible contiene /user/<identifier>, confirme que la ruta identifica la cuenta deseada, porque ese identificador se usa cuando user_id está en blanco.
  • No agregue results_limit ni un cursor de la fuente al envío; cada tarea realiza una sola solicitud a la fuente para una sola página.
  • Use cursor y limit solo en GET /v1/tasks/{task_id} una vez completada la tarea; limit tiene un valor predeterminado de 50 y acepta de 1 a 500 para los resultados almacenados.
  • Maneje como nulos el texto, los campos del autor, el contenido multimedia, la hora de publicación, los hashtags, las menciones y cada métrica, y aplique escape al texto público antes de mostrarlo.

Explorar otras plataformas

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

Rednote User Notes API — FAQ

Rednote User Notes API recopila una página de notas públicas a partir de una URL de usuario de Rednote compatible o un ID de usuario, y devuelve la identidad normalizada de la nota, el texto, el contexto del autor, el contenido multimedia, las marcas de tiempo y los campos de interacción visibles.

Indique al menos uno de los dos campos. Si están presentes ambos, user_id tiene prioridad; de lo contrario, se resuelve una ruta /user/<identifier> cuando está disponible y cualquier otra URL aceptada se usa como referencia de la cuenta.

El nombre de host analizado debe ser xiaohongshu.com, xhslink.com o un subdominio de cualquiera de los dos. El endpoint no exige una ruta concreta, pero el valor debe seguir refiriéndose a la cuenta pública deseada.

No. El contrato de envío no tiene results_limit ni cursor de la fuente y realiza una sola solicitud a la fuente. La paginación por cursor de GET /v1/tasks/{task_id} solo lee los registros ya almacenados de esa tarea.

Un resultado puede contener su ID y su URL pública, el texto, la identidad del autor, el contenido multimedia, published_at, collected_at, los hashtags, las menciones y los conteos visibles de Me gusta, comentarios, veces compartido y vistas. Los campos opcionales de la fuente pueden ser nulos.

Rednote User Notes usa una facturación fija de 1 crédito de SocQ por tarea y no por nota devuelta. La cantidad de resultados no cambia el cargo configurado.