API de Detalles de Xiaohongshu

Q: ¿Guardo user_id o red_id?

Guarda los dos, pero usa user_id como clave: es el valor que vuelves a pasar a esta capacidad y a Publicaciones del usuario. red_id lo elige el titular y es lo que la gente escribe en el buscador de la app, así que sirve para mostrarlo o para reconocer un ID que te envíen.

POST

Salud de la API

Salud 24 h: 100 %
Tiempo medio 24 h: 2.65 s

Saludable / normal
Disponible
Limitada
Casi sin servicio

Saludable

Últimas 24 horas

Últimos 30 días

Consulta una cuenta por user_id y recoge Red ID, biografía, verificación y contadores públicos, con seguidores exactos. No revela audiencia privada ni devuelve las notas de la cuenta, que se leen con Publicaciones del usuario.

Xiaohongshu Detalles lee el perfil de una cuenta a partir de su user_id: apodo, ID de Xiaohongshu, biografía, avatar, género, ubicación por IP, verificación, seguidores y seguidos, número de notas, y los me gusta y guardados que han acumulado sus notas. Les dice a marcas, agencias e investigadores qué tamaño y qué actividad tiene una cuenta antes de preseleccionar a un creador, cerrar una colaboración o añadirla a una lista de seguimiento.

Pasa el ID que sigue a /user/profile/ en el enlace del perfil, el propio enlace o el ID de autor de quien comenta en los resultados de Xiaohongshu Comentarios. Aquí follower_count es exacto, a diferencia de la cifra redondeada de Búsqueda de usuarios, y los recuentos que no son públicos llegan como null, no como cero. ip_location es la provincia o el país que la plataforma asigna a la cuenta, no un dato que rellene el titular, y real_name_info solo aparece cuando el perfil muestra datos de nombre real.

Precio $5.56 por 1.000 solicitudes ($0.005556 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

Prompt para IA

Pégalo en tu asistente de IA. Ya incluye los parámetros, los campos de respuesta y una solicitud de ejemplo de este endpoint, así que el asistente puede preguntarte qué necesitas y luego escribir el script.

Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Xiaohongshu: Detalles (xiaohongshu/profile).

Contrato del endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en xiaohongshu y action en profile, y los parámetros dentro de params.
- Parámetros obligatorios:
  - user_id: ID de usuario que aparece después de /user/profile/ en la URL de un perfil de Xiaohongshu, o la URL completa del perfil. También acepta el author_id que devuelven las acciones de comentarios.
- Devuelve un objeto. Campos principales: user_id, nickname (Nombre visible de la cuenta), red_id (ID de Xiaohongshu: el identificador bus…), url (Enlace del registro en Xiaohongshu), bio, follower_count (Número de seguidores), following_count, like_collect_count (Total de «me gusta» y guardados del per…), post_count, gender (Género tal como lo muestra el perfil), ip_location (Ubicación por IP (provincia o país) que…), avatar_url; 20 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "xiaohongshu",
  "action": "profile",
  "params": {
    "user_id": "5bec178863f51f0001859bd9"
  }
}
- Precio: $5.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

Nombre	Ubicación	Tipo	Obligatorio	Por defecto	Descripción
`Authorization`	header	`string`	Sí	-	Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
`platform`	body	`string`	Sí	`xiaohongshu`	Identificador de la plataforma, valor fijo.
`action`	body	`string`	Sí	`profile`	Identificador de la capacidad, valor fijo.
`user_id`	body.params	No declarado	Sí	-	ID de usuario que aparece después de `/user/profile/` en la URL de un perfil de Xiaohongshu, o la URL completa del perfil. También acepta el `author_id` que devuelven las acciones de comentarios. Se usa para obtener los datos de la cuenta o sus notas publicadas. No es el apodo.

Ejemplos de código

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "xiaohongshu",
  "action": "profile",
  "params": {
    "user_id": "5bec178863f51f0001859bd9"
  }
}'

[Definición OpenAPI (JSON)]Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Ejemplo de respuesta

Vista previa de campos

Todavía no hay una muestra real para estos parámetros de ejemplo: se muestra la estructura de la respuesta y sus campos según el contrato, con … como marcadores. No es el resultado de una llamada real.

json

{
  "id": "req_…",
  "platform": "xiaohongshu",
  "action": "profile",
  "results": {
    "user_id": …,
    "nickname": …,
    "red_id": …,
    "url": …,
    "bio": …,
    "follower_count": …,
    "following_count": …,
    "like_collect_count": …,
    "post_count": …,
    "gender": …,
    "ip_location": …,
    "avatar_url": …,
    "is_verified": …,
    "tags": …,
    "like_count": …,
    "collect_count": …,
    "real_name_info": …,
    "verification_type": …,
    "verification_text": …,
    "location": …,
    "platform": …
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Campos de la respuesta

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

Campo	Significado
`user_id`	Identificador único del usuario en la plataforma.
`nickname`	Nombre visible de la cuenta.
`red_id`	ID de Xiaohongshu: el identificador buscable que elige el titular, distinto del user_id interno.
`url`	Enlace del registro en Xiaohongshu. Los enlaces de `search`, `note`, `profile` y `hashtag` suelen incluir un token de acceso y se abren sin iniciar sesión (el token caduca; vuelve a llamar para obtener uno nuevo). Los enlaces de notas de `user_posts` no llevan token y lo necesitan para abrirse en el navegador: llama a `note` con el ID de la nota para obtener un enlace que se abra. Los enlaces de perfil de `search_users` tampoco llevan token; llama a `profile` con el `user_id` para obtener uno que se abra.
`bio`	Biografía escrita por la cuenta; puede incluir saltos de línea y emoji.
`follower_count`	Número de seguidores. Exacto en `profile`. Aproximado en `search_users`: la lista muestra una cifra redondeada (12 000 aparece como 1,2 × 10 000) que se convierte en un número entero. `null` significa que no es público o no se reconoció, no cero.
`following_count`	Cuentas seguidas. null significa no publicado, no 0.
`like_collect_count`	Total de «me gusta» y guardados del perfil: los «me gusta» recibidos más las veces que se guardaron las notas de la cuenta. `like_count` y `collect_count` dan las dos partes.
`post_count`	Total de publicaciones. null significa no publicado, no 0.
`gender`	Género tal como lo muestra el perfil; puede estar vacío.
`ip_location`	Ubicación por IP (provincia o país) que muestra Xiaohongshu; no la escribe el usuario. Solo algunas filas de `user_posts` la traen.
`avatar_url`	Enlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
`is_verified`	Si la plataforma verificó la cuenta. null significa que no se puede determinar.
`tags`	Lista de etiquetas: en note, las etiquetas de tema de la nota; en profile, las etiquetas personales que muestra el perfil (como signo del zodiaco o región), con su texto original.
`like_count`	Número de «me gusta». En resultados de notas y comentarios, los de ese elemento; en `profile`, el total que han recibido las notas de la cuenta. `null` significa que no es público o que no se obtuvo en esta llamada, no cero.
`collect_count`	Número de guardados. En resultados de notas, las veces que se guardó esa nota; en `profile`, el total de guardados de las notas de la cuenta. `null` significa que no es público o que no se obtuvo en esta llamada, no cero.
`real_name_info`	Datos de nombre real tal como los muestra el perfil; el campo no aparece si no hay.
`verification_type`	Tipo de verificación en `search_users` y `profile`: `individual` (persona verificada), `business` (empresa verificada) u `other`. Las cuentas sin verificar no incluyen este campo.
`verification_text`	Descripción de la verificación tal como figura en el perfil (profile).
`location`	Descripción de la ubicación tal como la da la plataforma; el formato varía.
`platform`	Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Preguntas frecuentes

¿Qué mide `like_collect_count`?

Es el total de me gusta y guardados que muestra el perfil: todos los me gusta más todas las veces que se guardaron las notas de la cuenta. like_count y collect_count dan las dos partes por separado, así que puedes ver si su público sobre todo da me gusta o guarda las notas para volver a ellas.

¿Guardo `user_id` o `red_id`?

Guarda los dos, pero usa user_id como clave: es el valor que vuelves a pasar a esta capacidad y a Publicaciones del usuario. red_id lo elige el titular y es lo que la gente escribe en el buscador de la app, así que sirve para mostrarlo o para reconocer un ID que te envíen.

¿El enlace del perfil se abre en el navegador?

Normalmente sí. Los enlaces de esta capacidad suelen llevar un token de acceso, de modo que se abren sin iniciar sesión hasta que el token caduca; una nueva llamada devuelve uno fresco. Los enlaces de perfil de Búsqueda de usuarios y los de notas de Publicaciones del usuario no lo llevan, y por eso esas capacidades te remiten aquí o a Detalles de la nota.

Errores y facturación

401: Falta la clave o no es válida. La autenticación se comprueba antes que los parámetros, así que las solicitudes sin autenticar no ven el esquema de parámetros.
422: Nombre o valor de parámetro incorrecto. El error enumera los parámetros y valores permitidos de esta capacidad y la opción más cercana; ocurre antes de cualquier cobro.
402: Saldo insuficiente. Recarga primero.
429: Se alcanzó el límite de solicitudes por minuto de la cuenta (todas sus claves API cuentan juntas; antes se aplica el límite propio de una clave si es menor). Espera lo que indique Retry-After y vuelve a intentarlo; un paquete de velocidad en la consola sube el límite.
503: No se pudo completar ahora. Cualquier cargo de la llamada vuelve automáticamente a tu saldo, y el recibo de facturación de la respuesta indica el resultado real, también cuando aún no se conoce. No reenvíes a ciegas.
200 vacío: La solicitud terminó sin datos y no se cobra (billing.reason = empty_result_refunded).