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ámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio (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_id | Obligatorio (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.
- 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.
- Envíe url o user_id por POST a /v1/rednote/user-notes 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 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 trueCasos 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.
APIs relacionadas
Además de la Rednote User Notes API, use estas APIs cuando necesite otro tipo de datos públicos de Rednote.