Rednote User Profile
Los perfiles públicos de Rednote pueden exponer un identificador de cuenta, el nombre de usuario de Rednote, el nombre visible, la biografía, las imágenes del perfil, el sitio web, los indicadores de cuenta y los conteos visibles de seguidores, seguidos y publicaciones. Un registro normalizado mantiene juntos esos campos de identidad disponibles y las señales de un momento dado, para relacionar cuentas, comparar perfiles seleccionados y analizar instantáneas repetidas.
Funcionalidades de la Rednote User Profile API
- Dos vías de búsqueda con prioridad explícitaResuelve un perfil a partir de una URL de Rednote compatible o de un user_id público. Si se proporcionan ambos campos, se usa el user_id explícito para la búsqueda en la fuente.
- Registro de identidad pública uniformeNormaliza el ID de la cuenta, la URL de origen, el nombre de usuario de Rednote, el nombre visible, la biografía, el avatar, la imagen de portada, el sitio web, el indicador de verificación y el indicador de privacidad que estén disponibles.
- Señales visibles de la cuenta con marca de tiempoDevuelve los conteos de seguidores, seguidos y publicaciones disponibles junto a collected_at, de modo que cada resultado siga siendo una observación de un momento dado y no un total en vivo.
Parámetros de la Rednote User Profile API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio (al menos uno) | Se requiere url o user_id. El nombre de host analizado debe ser xiaohongshu.com, xhslink.com o un subdominio de cualquiera de los dos. Si user_id también está presente, user_id tiene prioridad. |
user_id | Obligatorio (al menos uno) | Se requiere user_id o url. Use de 1 a 256 letras ASCII, números, dos puntos, guiones bajos o guiones. Este identificador explícito tiene prioridad cuando también se proporciona url. |
Cómo usar la Rednote User Profile API
Envíe una referencia de cuenta compatible, siga la tarea asíncrona y lea la cuenta normalizada de la página de resultados almacenada.
- Prepare un user_id público vigente o una URL cuyo nombre de host analizado sea xiaohongshu.com, xhslink.com o un subdominio de cualquiera de los dos.
- Envíe user_id, url o ambos a /v1/rednote/user-profile; cuando están presentes ambos, user_id tiene prioridad. Guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
- Lea la cuenta en data.results.items. Use next_cursor solo si el lector de resultados almacenados informa has_more como true.
REDNOTE_USER_ID=''
# Paste a current public Rednote account identifier before running.
curl -X POST "https://api.socq.ai/v1/rednote/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"user_id\":\"$REDNOTE_USER_ID\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is trueCasos de uso de la Rednote User Profile API
- Enriquecimiento de cuentas conocidas: Convierta una referencia existente de una cuenta pública de Rednote en un registro de identidad uniforme, con el texto del perfil, las imágenes, el sitio web y los indicadores de cuenta disponibles.
- Comparación de instantáneas de perfil: Compare cuentas seleccionadas o recopilaciones repetidas con los ID de resultado estables, collected_at y los conteos de seguidores, seguidos y publicaciones disponibles en el momento de la recopilación.
Consejos de expertos para la Rednote User Profile API
- Indique al menos una entrada. Cuando están presentes url y user_id, el backend usa el user_id explícito y no envía la URL a la búsqueda en la fuente.
- Prefiera user_id cuando ya tenga el identificador público de la cuenta; evita depender de la estructura de una URL compartida o de cuenta.
- Valide user_id con ^[A-Za-z0-9:_-]{1,256}$ y exija que el nombre de host de la URL analizada coincida con xiaohongshu.com, xhslink.com o un subdominio antes del envío.
- No agregue results_limit ni un cursor de la fuente. Este endpoint realiza una sola solicitud de detalle, mientras que next_cursor pertenece solo al lector de resultados almacenados de SocQ.
- Trate la biografía, las imágenes del perfil, el sitio web, los indicadores y cada métrica como opcionales. Conserve los valores nulos en lugar de convertir los campos ausentes en cadenas vacías o en cero.
- Un resultado previo de una cuenta de Rednote puede aportar su id canónico como user_id. Mantenga ese identificador distinto del username devuelto, que representa el nombre de usuario de Rednote disponible.
APIs relacionadas
Además de la Rednote User Profile API, use estas APIs cuando necesite otro tipo de datos públicos de Rednote.