rednote/
user-profile

Obtenga un perfil público de Rednote por URL de cuenta compatible o user_id, con identidad, imágenes del perfil, indicadores de cuenta, conteos visibles y hora de recopilación, todo normalizado.

Rednote User Profile API

URL o user_id
Una cuenta normalizada
Tarea fija de 1 crédito
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 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ámetrosObligatorioDescripción
urlObligatorio (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_idObligatorio (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.

  1. 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.
  2. 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.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
  4. 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 true

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

Explorar otras plataformas

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

Rednote User Profile API — FAQ

Rednote User Profile API obtiene como máximo un perfil público de Rednote a partir de una URL de cuenta compatible o un user_id y devuelve un registro de cuenta normalizado.

Use user_id cuando lo conozca. Puede enviar ambos campos, pero el user_id explícito tiene prioridad y la URL no se reenvía a la búsqueda en la fuente.

Una URL debe analizarse como xiaohongshu.com, xhslink.com o un subdominio. user_id debe contener de 1 a 256 letras ASCII, números, dos puntos, guiones bajos o guiones.

Un resultado puede incluir el ID, 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, los indicadores de verificación y privacidad, los conteos de seguidores, seguidos y publicaciones, y la hora de recopilación. Cada campo puede ser nulo.

No. user_id es un identificador de búsqueda aceptado y el resultado canónico tiene su propio id. username contiene el nombre de usuario de Rednote cuando la fuente lo proporciona, por lo que no conviene sustituir user_id por él sin verificar el valor de la fuente.

No. Una tarea realiza una sola solicitud de detalle de perfil y puede almacenar como máximo una cuenta. La respuesta común de resultados de tareas igualmente incluye items, next_cursor y has_more para leer los registros almacenados por SocQ.

Cada tarea exitosa de Rednote User Profile cuesta un monto fijo de 1.00 créditos de SocQ. La solicitud no se tarifica por cantidad de campos ni por cantidad de resultados almacenados.