API de Detalles de la nota de Xiaohongshu

POST

Salud de la API

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

Saludable / normal
Disponible
Limitada
Casi sin servicio

Saludable

Últimas 24 horas

Últimos 30 días

Abre la url de una nota y devuelve texto, autor, ubicación IP mostrada y métricas. No incorpora automáticamente todos los comentarios ni concede derechos sobre imágenes.

Xiaohongshu Detalles de la nota lee una nota a partir de su url y devuelve su contenido completo: el texto entero, todas las imágenes en orden, sus temas y las personas mencionadas, los «me gusta», guardados, comentarios y compartidos, y la fecha de publicación, con lat y lng cuando las imágenes llevan ubicación. Sirve para analizar qué dice de verdad una nota y cómo la recibió el público, revisar una campaña con creadores o convertir resultados de búsqueda en texto completo que puedas analizar.

Pasa el enlace completo de la nota sin quitar sus parámetros de consulta, como xsec_token; funciona mejor un enlace reciente sacado de la búsqueda, y un ID de nota suelto normalmente no basta. ip_location es la región IP que muestra Xiaohongshu, no una dirección que haya escrito el autor, y los IDs de tema de topics llevan a más notas sobre el mismo tema.

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 de la nota (xiaohongshu/note).

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 note, y los parámetros dentro de params.
- Parámetros obligatorios:
  - url: Enlace completo a una nota de Xiaohongshu, con la ruta /explore/<ID_de_nota> o /discovery/item/<ID_de_nota>. Se recomienda usar la URL completa obtenida en una búsqueda reciente, conservando parámetros como xsec_token.
- Devuelve un objeto. Campos principales: id, url (Enlace del registro en Xiaohongshu), title, text (Texto de la nota o del comentario), like_count (Número de «me gusta»), collect_count (Número de guardados), comment_count, share_count, posted_at, ip_location (Ubicación por IP (provincia o país) que…), author_name, author_id (ID de usuario del autor); 25 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "xiaohongshu",
  "action": "note",
  "params": {
    "url": "https://www.xiaohongshu.com/explore/6aa7a3f600000000110335f8?xsec_token=YByFNzoKupps8B3qI774Gx7XGxfHpq4QWEvxU4zsD8454%3D"
  }
}
- 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í	`note`	Identificador de la capacidad, valor fijo.
`url`	body.params	No declarado	Sí	-	Enlace completo a una nota de Xiaohongshu, con la ruta `/explore/<ID_de_nota>` o `/discovery/item/<ID_de_nota>`. Se recomienda usar la URL completa obtenida en una búsqueda reciente, conservando parámetros como `xsec_token`. La acción `sub_comments` también requiere el `comment_id` de un comentario de la misma nota.

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": "note",
  "params": {
    "url": "https://www.xiaohongshu.com/explore/6aa7a3f600000000110335f8?xsec_token=YByFNzoKupps8B3qI774Gx7XGxfHpq4QWEvxU4zsD8454%3D"
  }
}'

[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

Respuesta real

Obtenida el 15 de octubre de 2026, 15:16 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.

json

{
  "id": "req_…",
  "platform": "xiaohongshu",
  "action": "note",
  "results": {
    "id": "6aa7a3f600000000110335f8",
    "url": "https://www.xiaohongshu.com/explore/6aa7a3f600000000110335f8?xsec_token=YByFNzoKupps8B3qI774Gx7XGxfHpq4QWEvxU4zsD8454%3D",
    "title": "33㎡的一字户塞下28㎡收纳？！还巨显大！",
    "text": "感谢超有生活智慧的@（已隐去） 接受采访！\n本期视频超多干货！\n33㎡邪修出两房！2㎡卫生间硬塞浴缸🛁\n全屋28㎡收纳、衣柜800件衣服装不满！\n超低成本旋转鞋架、空调机位改树屋🌳\n把每一寸空间都榨干的小户型终极收纳来啦！\n#roomtour[话题]# #小户型收纳[话题]# #探家[话题]#  #小红书自建房大赏[话题]#  #WeeklyPick[话题]#  #野生体验家howto[话题]# #我在小红书搞装修[话题]# #装修内行人[话题]#",
    "like_count": 3421,
    "collect_count": 3928,
    "comment_count": 104,
    "share_count": 976,
    "posted_at": "2026-09-14T09:01:04+00:00",
    "ip_location": "（已隐去）",
    "author_name": "（已隐去）",
    "author_id": "（已隐去）",
    "is_video": true,
    "avatar_url": "https://sns-avatar-qc-ae.rednotecdn.com/（已隐去）",
    "author_url": "https://www.xiaohongshu.com/（已隐去）",
    "platform": "xiaohongshu",
    "images": [
      "https://sns-i11-ae.rednotecdn.com/spectrum/1040g34o3253cssm6302049v1t8cah4q0tpb8l58?imageView2/2/w/576/format/heif/q/58|imageMogr2/strip&redImage/frame/0/enhance/4&ap=1&sc=V_PRV&sign=ed0259e196793273f51646a46b2c1a02&t=6ad0ee3c"
    ],
    "tags": [
      "roomtour",
      "小户型收纳",
      "探家"
    ],
    "topics": [
      {
        "name": "roomtour",
        "topic_id": "6103b7a0b2363700017d720a"
      },
      {
        "name": "小户型收纳",
        "topic_id": "5be9634385cfbb000101d51f"
      },
      {
        "name": "探家",
        "topic_id": "6064a7711fd52f0001b7d830"
      }
    ],
    "mentioned_users": [
      {
        "user_id": "（已隐去）",
        "nickname": "（已隐去）"
      }
    ]
  },
  "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
`id`	Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
`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.
`title`	Título. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
`text`	Texto de la nota o del comentario. `note` y `hashtag` devuelven el texto completo; `search` y `user_posts` pueden devolver un extracto recortado (unos 60 y 100 caracteres como máximo, respectivamente). Llama a `note` con el ID de la nota para obtener el texto completo.
`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.
`comment_count`	Comentarios. null significa no publicado, no 0.
`share_count`	Veces compartido. null significa no publicado, no 0.
`posted_at`	Fecha de publicación en ISO 8601, UTC (por ejemplo 2026-08-07T12:34:56+00:00). Las cadenas no estándar de la plataforma se transmiten tal cual, así que conviene analizarlas con tolerancia. null significa que la plataforma no la publica.
`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.
`author_name`	Nombre visible del autor.
`author_id`	ID de usuario del autor. Puedes enviarlo a `profile` o `user_posts`. En los resultados de notas es el ID de 24 caracteres de la URL del perfil; en los de comentarios (`comments`, `comments_batch`, `sub_comments`) suele ser otra forma de 29 caracteres. Las dos formas de una misma persona no coinciden: antes de eliminar duplicados entre lotes, conviértelas con el `user_id` que devuelve `profile`.
`is_video`	Si la nota es de vídeo. La URL de reproducción NO va en la respuesta del detalle de la nota (desde 2026-10-14): llama a la acción video aparte con la misma URL de la nota para obtenerla; cada llamada se cobra por uso.
`avatar_url`	Enlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
`author_url`	Enlace al perfil del autor. No lleva token de acceso, así que no se abre sin iniciar sesión; la `url` que devuelve `profile` para el `author_id` sí se abre directamente.
`platform`	Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
`images`	Enlaces de imágenes. En `note`, `hashtag`, `search` y `user_posts`, todas las imágenes de la nota en orden. En los resultados de comentarios (`comments`, `comments_batch`, `sub_comments`), las imágenes adjuntas al comentario, incluidos los stickers; un array vacío significa que no hay ninguna. `null` significa que esta vez no se obtuvo este dato.
`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.
`topics`	Temas de la nota, cada uno con `name` y `topic_id` (el ID de la página de tema). Envía `topic_id` a `hashtag` para leer las notas de ese tema. El campo no aparece si la nota no tiene temas o si no se obtuvieron.
`mentioned_users`	Personas mencionadas con @: en los resultados de comentarios, las mencionadas en el comentario; en note, las mencionadas en la nota. Cada entrada tiene user_id y nickname. No aparece si no hay ninguna.
`lat`	Latitud de la ubicación adjunta a las imágenes de la nota (note), con su valor original; no aparece si no hay ubicación.
`lng`	Longitud de la ubicación adjunta a las imágenes de la nota (note); aparece junto con lat.
`has_goods`	Conserva el significado de la plataforma
`author_red_id`	ID de Xiaohongshu del autor: en los resultados de comentarios (`comments`, `comments_batch`, `sub_comments`) es el de quien comenta; en `note`, el del autor de la nota.
`author_is_verified`	Conserva el significado de la plataforma
`language`	Código de idioma del contenido (por ejemplo zh, en) según la plataforma; puede no ser exacto.

Preguntas frecuentes

¿Por qué no funciona un ID de nota suelto?

Las páginas de notas de Xiaohongshu necesitan el token de acceso que viaja en el enlace. Pasa la URL completa, con la ruta /explore/<ID de la nota> o /discovery/item/<ID de la nota>, y conserva parámetros como xsec_token. La url de los resultados de búsqueda ya lleva el token, así que puedes pasarla tal cual.

¿`ip_location` es el lugar donde vive el autor?

No exactamente. Es la región IP, una provincia o un país, que Xiaohongshu muestra en cada publicación. La fija la plataforma y no el autor, así que sirve para análisis regionales aproximados, pero no debe tomarse como una ubicación precisa.

¿Por qué una nota de vídeo no trae el enlace del vídeo?

Detalles de la nota no incluye el enlace de reproducción; marca las notas de vídeo con is_video. Para obtenerlo, llama a Detalles del video con la misma url de la nota: devuelve el enlace de reproducción y la duración, y se cobra como una llamada aparte. Las notas de vídeo encontradas con la búsqueda ya traen el enlace en su fila.

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