API de Xiaohongshu (RedNote): plataforma oficial, scripts de GitHub o pago por llamada

Quien busca una «xiaohongshu api» o una «rednote api» casi siempre quiere lo mismo: las publicaciones y los comentarios públicos de otras cuentas. El 4 de noviembre de 2026, la plataforma oficial de Xiaohongshu no ofrecía eso. Su plataforma de cuentas abre un solo permiso, basic_info, con cuatro campos: apodo, avatar, género y región. El permiso para leer notas sigue marcado como «planificado» (lista de permisos). También revisamos nueve scripts de código abierto muy usados en GitHub. En los últimos 90 días recibieron 92 incidencias nuevas, y 31 hablan de un inicio de sesión roto, un bloqueo o un cambio de página. Después pagamos nueve llamadas reales con EveryInfra. Cada una costó 0,005556 USD. Una página de búsqueda devolvió 20 notas, es decir, 0,278 USD por cada 1.000 notas. Los resultados vacíos y los parámetros mal escritos no se cobraron.

Este artículo compara tres formas de obtener datos de Xiaohongshu. La primera es la plataforma abierta oficial. La segunda es un script de código abierto que funciona con tu propia sesión. La tercera es una API de datos de un tercero que cobra por petición. Para las dos primeras usamos solo material público: la documentación oficial, los datos públicos de GitHub y sus incidencias. Para la tercera usamos nuestra propia API, EveryInfra, y damos el cobro real que aparece en cada respuesta. No nombramos otros servicios de terceros. La sección sobre cómo comparar precios de terceros te da una fórmula para comparar cualquier lista de precios por tu cuenta.

La respuesta corta: qué puede hacer cada vía

Las tres vías no son tres precios para lo mismo. Llegan a datos distintos. La plataforma oficial sirve para lo tuyo: el inicio de sesión de tu app, los pedidos de tu tienda y los informes de tus anuncios. No tiene ningún punto de acceso para buscar notas de otros ni para leer sus comentarios. Un script de GitHub puede leer casi todo lo que ves en el navegador, porque actúa como un navegador con tu sesión. Por eso lo que puede leer, y durante cuánto tiempo, depende de tu cuenta y de cómo esté la web esa semana. Una API de pago por llamada convierte la misma tarea en una petición HTTP normal. Pagas cada petición, y los datos disponibles y las filas por página son los que el proveedor publica en su catálogo.

La primera fila es la que más se pasa por alto. Un plan habitual es «pedir primero la API oficial y buscar otra cosa solo si dicen que no». Pero hoy los permisos relacionados con contenido público, user_profile, read_notes y read_followers, siguen cerrados. Incluso con una app aprobada, recibes el apodo y el avatar de la persona que inicia sesión, nada más. Las secciones siguientes revisan cada vía con el texto original o con nuestros datos de prueba.

¿Existe una API oficial de Xiaohongshu? Cuatro puertas con cuatro funciones

Sí, y hay más de una. Cada una cubre una función distinta. El 4 de noviembre de 2026 abrimos todos los sitios públicos para desarrolladores de Xiaohongshu y anotamos a quién se dirige cada uno, qué piden para entrar y qué datos dan.

La plataforma de cuentas es la puerta más nueva. Su portada dice que da a tu app un inicio de sesión con Xiaohongshu mediante OAuth 2.0 estándar (portal para desarrolladores). La guía de inicio rápido indica que una app nueva espera entre 1 y 3 días hábiles de revisión. También indica que ahora solo está abierto el permiso basic_info (inicio rápido). La página de permisos enumera cinco. Solo basic_info tiene el estado «abierto». Los otros cuatro están «planificados», y write_notes añade que necesita revisión manual y que solo se abre en casos concretos (lista de permisos).

La referencia de la API tiene 11 puntos de acceso, y todos tratan de tokens y de inicio de sesión. Sirven para consultar el estado, obtener y renovar un token, leer la información básica del usuario, revocar el acceso y entrar con código QR en pantallas de coche y en webs. La página se actualizó por última vez el 19 de agosto de 2026 y da al token de renovación una vida de 180 días (referencia de la API).

La plataforma de comercio electrónico es la que conocen los vendedores. Tiene dos perfiles de desarrollador. El proveedor de software crea herramientas de pedidos, productos o ERP para muchas tiendas y publica su app en un mercado de servicios. El desarrollo propio crea herramientas solo para su tienda. Las reglas de entrada son estrictas. Un proveedor debe ser una empresa registrada en China continental hace más de un año, con desarrollo o servicios técnicos en su objeto social. El desarrollo propio no admite tiendas de particulares (guía de perfiles, copia de terceros de la documentación).

La guía de autorización dice que solo la cuenta principal de la tienda puede autorizar una app. El código de autorización dura 10 minutos, el token de acceso 7 días y el token de renovación 14 días (flujo de autorización para proveedores). Todas las llamadas de negocio van a una misma dirección y llevan una firma MD5 hecha con appId, timestamp, version, method y el secreto de la app (método de firma). Esta puerta conecta tu tienda con tus sistemas. Su límite de datos es la tienda que te autorizó.

La tercera puerta es la API de marketing de anuncios. Su guía de inicio dice que se dirige a clientes clave del sector que ya invierten en anuncios en la plataforma y tienen experiencia con APIs. Un comercial de la plataforma inicia el registro del desarrollador (guía de la API de marketing). Da informes y control de campañas de tu propia cuenta publicitaria, no notas orgánicas.

La cuarta puerta es la plataforma para compartir, que ofrecía «compartir con un toque» y «publicación rápida» a otras apps (plataforma para compartir). En noviembre de 2025 un desarrollador publicó que la página no tenía botón de alta y mostraba un estado de pausa (foro). Cuando la abrimos el 4 de noviembre de 2026, seguía sin entrada de registro. Existe además una plataforma de miniprogramas para apps que funcionan dentro de Xiaohongshu (plataforma de miniprogramas), que tampoco lee contenido de la comunidad.

Lo que la plataforma oficial no te da

Si juntas las cuatro puertas, la conclusión es sencilla. Las APIs oficiales miran hacia dentro: tu cuenta, tu tienda y tus anuncios. La documentación de las cuatro puertas no incluye ningún punto de acceso para que un tercero busque en todas las notas, lea los comentarios de cualquier nota o abra cualquier perfil público. En la lista de permisos, read_notes y read_followers siguen «planificados».

Para quien vive fuera de China continental hay un segundo documento. Quien se registra fuera de China continental es usuario de RedNote y sigue los términos de RedNote, en vigor desde el 9 de junio de 2026, con Rednote Technology Pte. Ltd. como operador (términos de servicio de RedNote). Lo que dicen ambos textos sobre la lectura automática está en la sección de cumplimiento, más abajo. Así que la pregunta por una «rednote api» tiene la misma respuesta que la de la «xiaohongshu api». En ninguna de las dos versiones hay una API oficial para leer contenido público.

Detrás de la búsqueda «xiaohongshu api» hay, por tanto, dos necesidades distintas. Si necesitas el inicio de sesión de tu app, la conexión con tu tienda o los informes de tus anuncios, usa la puerta oficial y no hace falta que sigas leyendo. Si necesitas seguir a la competencia, escuchar lo que se dice de una marca, investigar productos o ver tendencias de contenido, las puertas oficiales no ayudan hoy. Te quedan los scripts o una API de terceros, y en los dos casos conviene conocer los límites legales de la sección de cumplimiento.

La xiaohongshu api en GitHub: nueve repositorios populares, medidos

Los scripts de código abierto son la primera opción de muchos desarrolladores: son gratis y puedes leer el código. No queríamos escribir «los scripts fallan mucho» de memoria. Por eso hicimos una muestra en GitHub a las 00:19:50 del 4 de noviembre de 2026, hora de Singapur, con la API de GitHub. La regla fue esta. Buscamos xiaohongshu, xhs spider y el nombre chino de la app. Tomamos los 30 primeros resultados por estrellas de cada búsqueda y quitamos los duplicados. Luego nos quedamos solo con los repositorios cuyo trabajo principal es obtener datos: rastreadores, envoltorios de peticiones, servidores MCP, herramientas de línea de comandos y descargadores.

Quitamos las herramientas que solo publican, generan imágenes o descargan vídeos de muchas webs. Pasaron nueve. «Incidencias en 90 días» son las abiertas entre el 6 de agosto y el 4 de noviembre de 2026, sin contar solicitudes de cambios (API de incidencias de GitHub).

Leímos el título de cada incidencia y la clasificamos a mano en cuatro grupos. El primero es el fallo de sesión, cookie, código QR o login (10 incidencias). El segundo son verificaciones, búsquedas limitadas o peticiones bloqueadas (3). El tercero son lecturas, análisis o automatizaciones que fallan o se agotan tras un cambio en la página o en el punto de acceso (18). Las otras 61 son peticiones de funciones, problemas de instalación, avisos de seguridad, promociones o títulos sin contenido claro. Los títulos pueden engañar: tres incidencias solo decían «problema» y las contamos como «otras». Así que 31 es un mínimo.

Estas cifras no dicen que los proyectos activos sean malos. Es al revés: un proyecto recibe muchas incidencias porque mucha gente lo usa y su autor responde. xiaohongshu-mcp tuvo 35 cambios en 30 días. Entre sus incidencias recientes están «no puedo iniciar sesión» (#880, 23 de octubre) y «la búsqueda está limitada, pero la app del móvil funciona» (#877, 21 de octubre). Un usuario preguntó sin rodeos si la plataforma permite la herramienta y si su uso puede reducir el alcance de sus propias notas (#878, 22 de octubre).

La incidencia #497 de XHS-Downloader (17 de octubre) muestra un cambio de página típico. Los datos del servidor dentro de la web empezaron a usar una sintaxis nueva, y el analizador dejó de funcionar. En el mismo repositorio, la #479 pide un ajuste para ir más despacio y no activar las defensas de la web. El título de la incidencia #191 de Spider_XHS (10 de octubre) lo resume todo: «Cookie is invalid or expired».

El otro riesgo es el proyecto que nadie mantiene. ReaJason/xhs es un envoltorio de peticiones para la web de Xiaohongshu. Su último cambio fue el 1 de julio de 2025, hace 490 días. xiaohongshu-cli se detuvo el 21 de marzo de 2026. Que no haya incidencias nuevas no quiere decir que el código funcione; puede querer decir que los usuarios se fueron. Antes de elegir un script para una tarea diaria, mira tres cosas: la fecha del último cambio, si las incidencias del último mes hablan de sesión, caducidad o errores de análisis, y lo rápido que responde el autor.

Los costes reales de los scripts: sesión, firmas, la división de RedNote y licencias

El primer coste es la sesión. Casi todos los scripts populares te piden iniciar sesión y guardar la cookie. El README de xiaohongshu-mcp avisa en negrita de que una cuenta no puede estar abierta en varios clientes web a la vez. Si entras desde otro cliente web, la herramienta pierde la sesión. El autor también advierte de que una cuenta nueva sin verificación de nombre real activará una comprobación (README de xiaohongshu-mcp). Un usuario de xiaohongshu-cli se quejó en la #82 de que la herramienta le obligaba a entrar de nuevo cada 7 días.

Cuando la sesión caduca, la tarea programada se para, y muchas veces te enteras cuando el informe siguiente sale vacío. La cuenta también está en juego. El artículo 2.3 del acuerdo de usuario dice que una cuenta es solo para su titular y que cederla a un tercero no es válido. La plataforma puede bloquear las cuentas que considere de riesgo (acuerdo de usuario). Trata la cuenta que ejecuta tu script como algo que puedes perder en cualquier momento.

El segundo coste es la firma de las peticiones. Las peticiones a la web de Xiaohongshu llevan cabeceras de firma como x-s y x-s-common, y algunos puntos de acceso piden una cabecera antibot más. Hay repositorios dedicados solo a esto. El README de xhshow dice que genera las cabeceras x-s, x-s-common y x-rap-param, y que el feed, la búsqueda y la publicación necesitan la cabecera extra x-rap-param (Cloxl/xhshow). MediaCrawler lo resuelve de otra forma. Mantiene la sesión en un navegador Playwright y ejecuta JavaScript dentro para obtener los valores de la firma. Su README dice que se conecta al Chrome que el usuario ya tiene para reducir el riesgo de detección (README de MediaCrawler). Los dos métodos comparten un punto débil: cuando cambia el método de firma, todos los scripts que dependen de él se paran a la vez.

El tercer coste importa mucho a quien trabaja desde España o Latinoamérica: la división de RedNote. La incidencia #579 de xiaohongshu-mcp lo explica. Quien se registró con un teléfono no chino después del 8 de diciembre de 2025 es usuario de RedNote. Su sesión web va a rednote.com y sus cookies usan el dominio .rednote.com. Los scripts que solo leen cookies de xiaohongshu.com repiten «sin sesión». Si tu equipo en Madrid, Barcelona o Ciudad de México abrió sus cuentas con números locales en 2026, muchos tutoriales no te van a funcionar.

El cuarto coste es la licencia, y mucha gente no la lee. La licencia de MediaCrawler se llama «NON-COMMERCIAL LEARNING LICENSE 1.1». Dice que el software es solo para aprender e investigar. No se puede usar para rastreos a gran escala ni para perturbar la plataforma. El uso comercial exige el permiso por escrito del titular (licencia de MediaCrawler).

Spider_XHS y xiaohongshu-cli no declaran licencia en GitHub. GitHub explica que, sin licencia, el autor conserva todos los derechos y nadie más tiene permiso para usar, cambiar o compartir el código (documentación de GitHub sobre licencias). Una empresa que mete ese código en un producto o en una entrega a un cliente lo tendrá difícil con su equipo legal.

Pago por llamada: qué probamos

La tercera vía es una API de datos que cobra por petición. Envías una petición HTTP, el proveedor devuelve una página de datos estructurados y pagas cada petición. Hicimos llamadas reales con EveryInfra entre las 00:14 y las 00:20, hora de Singapur, del 4 de noviembre de 2026. Probamos seis acciones de Xiaohongshu en nueve llamadas pagadas. Además, hicimos fallar tres peticiones a propósito, y otras cuatro chocaron con el límite de velocidad (429) y funcionaron al reenviarlas. Primero leímos el catálogo gratuito para confirmar parámetros y precios (catálogo, leído a las 00:13, hora de Singapur).

Xiaohongshu tiene 17 acciones. Dieciséis cuestan 0,005556 USD por llamada y una lista de clasificación para marketing de creadores cuesta 0,016 USD. La búsqueda, las notas de una cuenta y la búsqueda de productos devuelven 20 filas por página; los comentarios, 15; las respuestas, 10. El token de página sirve durante 24 horas.

Las nueve llamadas costaron 0,061115 USD en total, con 11 unidades de cobro (el lote de 3 notas cuenta como 3). Dividimos el cobro entre las filas que llegaron, no entre el tamaño de página del catálogo. Por eso las llamadas con 19 filas salen un poco más caras por fila. La diferencia más grande es la del detalle de una nota. Cuesta lo mismo que una búsqueda, pero la búsqueda trae 20 notas y el detalle trae 1. Por fila, el detalle es 20 veces más caro. Para análisis masivos, usa los campos que ya vienen con la búsqueda (título, fragmento, me gusta, guardados, número de comentarios, fecha y autor) y pide el detalle solo cuando necesites más.

Un ejemplo para España: qué buscan los viajeros chinos sobre Barcelona

Para lectores de España, la prueba más útil fue la búsqueda en chino de «viaje a Barcelona», hecha a las 00:18 del 4 de noviembre de 2026, hora de Singapur. Devolvió 20 notas por 0,005556 USD. A diferencia de búsquedas de guías generales, aquí el contenido era reciente: 7 de las 20 notas tenían menos de 30 días y la nota mediana tenía 38 días. La mediana de me gusta fue 247,5, mucho más alta que en la búsqueda de protector solar.

La nota con más interacción era un vídeo del 23 de octubre de 2026 sobre cuánto cuesta un día en Barcelona entre comida, alojamiento y transporte. Tenía 5312 me gusta, 2395 guardados y 301 comentarios. Le seguía una lista de sitios donde comer del 9 de octubre, con 1817 me gusta y 2573 guardados: más guardados que me gusta, una señal clara de que la gente la usa como guía. Una nota de octubre de 2025 sobre errores con el transporte público sumaba 100 comentarios. Y una nota del 9 de septiembre de 2026 que comparaba el taxi con «pagar protección a los carteristas» tenía solo 119 me gusta, pero 99 comentarios. Ese tipo de nota, con muchos comentarios por cada me gusta, es justo la que conviene abrir con xiaohongshu/comments.

Para una oficina de turismo, un hotel o un restaurante, esta tabla ya dice mucho: preocupa el coste, preocupa la seguridad y lo práctico acaba en guardados. Con 0,005556 USD por página de búsqueda y otra llamada por cada página de comentarios, revisar las 5 notas más comentadas de una palabra clave cuesta 6 llamadas, unos 0,033 USD.

Las dos búsquedas, lado a lado, con el orden por defecto:

La prueba dejó cuatro detalles más. Primero, la paginación avanza de verdad: la página 2 de protector solar no repetía ninguna nota de la página 1. De esas 40 notas, 21 tenían menos de 30 días, 12 menos de 7 días y la más antigua 231 días. Segundo, el detalle vuelve a leer la nota en vivo: la nota mostraba 231 comentarios en la búsqueda y 232 en el detalle dos segundos después. El detalle añade la región IP, 8 etiquetas de tema y una lista de 10 imágenes.

Tercero, las respuestas necesitan su propia llamada. Los 15 comentarios principales de la página 1 declaraban 53 respuestas, pero cada uno traía solo 1 dentro. Para hilos completos, usa xiaohongshu/sub_comments. Cuarto, comments_batch cobra por nota. Tres notas cuestan tres veces 0,005556 USD, así que el precio por comentario es el mismo que con llamadas sueltas. El lote ahorra peticiones y margen del límite de velocidad, no dinero.

Cómo conectarse: curl, campos y MCP

La conexión más sencilla es una petición POST. Esta es la búsqueda de Barcelona de la tabla. Guarda la clave en una variable de entorno, no en tu código:

curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"xiaohongshu","action":"search","params":{"keyword":"巴塞罗那旅行","sort":"most_commented","date_range":"last_30_days"}}'
# Página siguiente: copia next_page_token en params.page_token. Para tareas lentas añade "mode":"async" y consulta el job_id.

Los campos de la respuesta coinciden con la lista response_fields del catálogo. La tabla muestra los grupos que usamos y lo que vimos en la prueba:

Para clientes de IA, EveryInfra es un servidor MCP remoto. MCP (Model Context Protocol) es un protocolo abierto que permite a un cliente de IA llamar a herramientas externas (especificación). Todos los nombres de herramienta empiezan por everyinfra_. Añade este bloque al cliente y listo:

{
  "mcpServers": {
    "everyinfra": {
      "url": "https://api.everyinfra.com/mcp",
      "headers": { "Authorization": "Bearer ${env:EVERYINFRA_API_KEY}" }
    }
  }
}

Luego puedes pedirlo con palabras normales: «Busca en Xiaohongshu notas sobre Barcelona de los últimos 30 días. Quédate con las que tengan más de 20 comentarios y baja una página de comentarios de cada una. Resume las quejas más repetidas.» Las páginas de cada acción y el área de pruebas están en API de datos de Xiaohongshu y búsqueda. Las comprobaciones de MCP están en configuración de MCP remoto, y las herramientas de Xiaohongshu en MCP de Xiaohongshu.

Fallos, vacíos y límites de velocidad: qué es gratis

El mayor miedo con el pago por llamada es pagar por nada. Hicimos fallar tres peticiones a propósito (vacío, parámetro erróneo y sin clave); otras cuatro chocaron con el límite de velocidad (429). Ninguna de las siete se cobró:

El resultado vacío tardó 29 segundos. La respuesta dice count 0 y reason empty_result_refunded, y no se cobró nada. El error 422 enumera los valores válidos, algo muy útil cuando un modelo de IA llama a la API: lee did_you_mean y corrige la petición solo.

El límite de velocidad se cuenta por cuenta, y todas las claves de la cuenta lo comparten, así que abrir más claves no da más margen. El límite de la cuenta depende del total recargado (precios). Los cuatro 429 no fueron a propósito. Nuestra clave de prueba tenía su propio tope de 10 llamadas por minuto, y entre las 00:14:59 y las 00:15:48 nosotros solo enviamos 4, así que otras pruebas usaban la misma clave a la vez.

Cada 429 decía «Nothing was charged» y daba un retry_after de 5 a 17 segundos. Reenviamos las cuatro peticiones entre 77 y 147 segundos después, y las cuatro funcionaron al precio normal de 0,005556 USD. En una tarea programada, espera lo que indica retry_after, reintenta y deja tiempo de cola en cada ronda. El método completo para cuadrar cobros y devoluciones está en conciliación de reembolsos por fallo.

Precio de la API de Xiaohongshu (xiaohongshu api pricing): 10 veces TikTok, presupuesto aparte

Lo decimos claro: en nuestro propio catálogo, Xiaohongshu es la red social más cara. Tomamos la mediana del precio de todas las acciones disponibles de cada plataforma. Xiaohongshu cuesta 0,005556 USD por llamada. TikTok, YouTube, Instagram, Bilibili y Reddit cuestan 0,000556 USD, justo la décima parte. Douyin, Kuaishou, Weibo, Zhihu y X cuestan 0,000806 USD, así que Xiaohongshu es 6,9 veces más cara. Taobao y JD cuestan 0,001389 USD, y Xiaohongshu es 4 veces más cara. Solo Amazon queda algo por encima, con una mediana de 0,006875 USD.

El precio de catálogo de Xiaohongshu es entre 4 y 10 veces el de otras plataformas; la página de precios tiene las cifras vigentes. En presupuesto: con 10 USD al mes haces unas 1800 llamadas a Xiaohongshu a 0,005556 USD, y unas 18.000 a la mediana de TikTok de 0,000556 USD. Para ti significa que el mismo presupuesto compra más o menos la décima parte de peticiones que en TikTok. Si un proyecto cubre las dos plataformas, no uses un único precio para las dos. Y significa que la sección siguiente, cómo llamar menos, importa aquí más que en otras plataformas.

Cómo llamar menos: cinco hábitos y una factura mensual

Primero, usa listas antes que detalles. La búsqueda y las notas de una cuenta traen 20 filas por página con título, fragmento, me gusta, guardados, número de comentarios, fecha y enlace, y casi todos los filtros se resuelven con eso. Pide xiaohongshu/note solo para la región IP, las etiquetas o el texto completo, porque cada fila de detalle cuesta 20 veces una fila de lista. Segundo, mira el número de comentarios antes de bajarlos. En nuestra muestra de 40 notas de protector solar, la mediana fue 14 y solo 18 notas tenían 20 o más. Pedir comentarios de una nota sin comentarios da un vacío; no se cobra, pero ocupa un hueco del límite de velocidad.

Tercero, usa filtros de fecha en lugar de volver a bajarlo todo. Una tarea diaria puede usar sort con newest y date_range con last_24_hours o last_7_days, y procesar solo lo nuevo. Cuarto, abre los hilos de respuestas solo cuando haga falta: sub_comment_count ya te dice cuántas respuestas tiene cada comentario. Quinto, ejecuta la tarea solo con la frecuencia que necesita el negocio. Muchos informes de competencia funcionan bien una vez por semana.

La tabla usa el precio de catálogo de 0,005556 USD. La proporción de notas con 20 o más comentarios, 18 de 40, sale de nuestra muestra. Es una estimación, no una factura, y tus palabras clave darán otra proporción. Lo importante es que el mismo seguimiento baja de 70,01 USD a 4,44 USD al mes, 15,8 veces menos. El ahorro sale de llamar menos, no de un precio unitario más bajo. Aquí el pago por llamada ayuda: cada llamada se ve, así que sabes de antemano cuánto ahorra cada recorte.

Veamos el segundo hábito con más detalle, con las mismas 40 notas de protector solar de nuestra búsqueda. Entre todas sumaban 1177 comentarios. Once notas tenían 0 comentarios, 18 tenían 20 o más y la más comentada tenía 231. La tabla usa el precio de catálogo de 0,005556 USD por página y 15 comentarios por página:

La última fila sale a 0,444 USD por cada 1.000 comentarios, más que los 0,370 USD de una primera página, porque la última página de cada nota no suele estar llena.

Así que decide antes si de verdad necesitas todos los comentarios. Para clasificar opiniones, los 15 comentarios principales de cada nota suelen bastar. Baja todas las páginas solo si necesitas una proporción sobre el total, por ejemplo cuántos comentarios nombran una marca. Una sola nota se calcula igual: la nota con 232 comentarios de nuestra llamada de detalle necesita 16 páginas, o 0,0889 USD.

Con las respuestas pasa lo mismo. Los 15 comentarios principales de una página declaraban 53 respuestas, y cada uno ya traía 1 dentro. Abrir todas las demás con xiaohongshu/sub_comments, a 10 filas por página, cuesta 14 llamadas, o 0,0778 USD. Si solo abres los 4 comentarios con 5 o más respuestas, son 4 llamadas, o 0,0222 USD: más de un 70 % menos, y conservas los hilos más activos.

Por último, el tiempo. Nuestra clave de prueba permite 10 llamadas por minuto. A esa velocidad, el plan diario con comentarios de todas las notas necesita 420 llamadas al día, 42 minutos de cola. El plan semanal con comentarios solo de las notas activas necesita 200 llamadas por ronda, 20 minutos. Los límites de una cuenta dependen del total recargado (precios); con cualquier límite, menos llamadas también significan menos cola y menos errores 429.

Cómo comparar precios de terceros: una fórmula y seis preguntas

Muchos servicios de terceros cobran por petición, y escriben sus precios de muchas maneras. Unos cobran por llamada, otros por fila y otros por créditos. Algunos añaden una cuota mensual o una tarifa de arranque. Para compararlos, usa una sola fórmula. Precio por cada 1.000 filas = precio por petición ÷ filas devueltas por petición × 1.000. Un ejemplo inventado: un servicio que cobra 0,01 USD por llamada y devuelve 10 filas cuesta 1,00 USD por cada 1.000 filas. Con los mismos 0,01 USD y 20 filas, cuesta 0,50 USD. El «precio por llamada» por sí solo dice poco. Pregunta cuántas filas trae cada página o, mejor, haz una llamada y cuéntalas. Con esta fórmula, nuestra búsqueda de Xiaohongshu cuesta 0,278 USD por cada 1.000 notas y los comentarios 0,370 USD por cada 1.000.

Las filas dos, tres y cuatro son las que más se pasan por alto. Con muchas palabras raras, o con un cliente de IA que a veces envía un parámetro erróneo, el coste de fallar entra en tu factura mensual. En nuestra prueba, las siete peticiones sin datos (tres fallos a propósito y cuatro límites de velocidad) costaron 0 USD. Pregunta por estas filas y luego haz una llamada tú mismo y cuenta las filas. Los precios y las reglas están en la página de precios.

Cumplimiento: normas, términos de la plataforma y prácticas para quien usa los datos

Esto no es asesoramiento legal. Resumimos los puntos principales de la ley y de los términos de la plataforma; consulta a un abogado sobre tu caso. Tres normas chinas tocan de lleno los datos de Xiaohongshu. El artículo 27 de la Ley de Protección de Información Personal permite tratar, «dentro de un alcance razonable», la información que la propia persona hizo pública o que ya es pública de forma legal. No se aplica si la persona se opone con claridad, y exige consentimiento cuando el tratamiento le afecta de forma importante (Ley de Protección de Información Personal).

El artículo 18 del Reglamento de Gestión de la Seguridad de los Datos de Red trata de las herramientas automáticas que acceden a datos o los recogen. Quien las usa debe evaluar el efecto sobre el servicio. No puede entrar en redes ajenas ni perturbar el funcionamiento normal del servicio (texto del reglamento). El reglamento está en vigor desde el 1 de enero de 2025 (Ministerio de Justicia). La Ley contra la Competencia Desleal, reformada en 2025, añade el artículo 13.3. Una empresa no puede obtener ni usar datos que otra tiene de forma legal mediante fraude, coacción o eludiendo o rompiendo sus controles técnicos. La ley reformada entró en vigor el 15 de octubre de 2025 (Ley contra la Competencia Desleal, 2025).

También se aplican dos textos de la plataforma. El acuerdo de usuario de Xiaohongshu se actualizó el 23 de marzo de 2026. Sus artículos 3.4 y 4.1 limitan leer, contar y usar con fines comerciales el contenido de la plataforma sin permiso por escrito, y limitan la extracción y las descargas simuladas. El artículo 2.3 limita prestar la cuenta a otros (acuerdo de usuario). Quien se registra fuera de China continental sigue los términos de RedNote, en vigor desde el 9 de junio de 2026, que también limitan la extracción automática de datos (términos de servicio de RedNote). Pregunta a un abogado si tu uso entra en esos límites.

En la práctica judicial china hay casos en los que se concedió una indemnización por recoger datos de una plataforma de forma masiva y sin permiso y revenderlos. En general, los tribunales se hacen cuatro preguntas. ¿Se eludieron o rompieron controles técnicos? ¿Los registros sueltos se convirtieron en una gran colección para revender? ¿Se tocaron datos personales o funciones privadas? ¿Se afectó al funcionamiento normal de la plataforma?

Elijas la vía que elijas, quien usa los datos debería mantener al menos estas prácticas:

• Usa los datos solo para un fin legal y claro, como la escucha de marca o la investigación de producto. Deja el fin por escrito y revísalo antes de cambiarlo.
• Respeta los términos de la plataforma y la ley del lugar donde trabajas. Consulta a un abogado antes de cualquier uso que los términos limiten, como la reventa comercial o la descarga masiva de contenido.
• Reduce al mínimo los datos personales. Trata los apodos, los avatares y las regiones IP de los comentarios como datos personales. No guardes campos que tu análisis no usa, guarda totales en lugar de filas sueltas cuando puedas y deja por escrito cuánto tiempo los guardas y para qué.
• No revendas datos en bruto. Entrega a tus clientes conclusiones y tablas resumen, no paquetes de filas en bruto, y no publiques filas en bruto.
• Toma solo lo que tu análisis necesita y borra los datos en bruto antiguos con un calendario fijo.
• No toques mensajes privados, cuentas privadas ni otro contenido que no sea público, y no uses los datos para enviar mensajes masivos a usuarios.

Estas prácticas van en la misma dirección que los hábitos de la sección «Cómo llamar menos». Si tomas solo lo que tu análisis usa, pagas menos y además tienes menos datos que guardar y proteger.

Qué vía elegir según tu trabajo

Si creas tu propia app y quieres «entrar con Xiaohongshu», usa la plataforma de cuentas y pide basic_info. Crea la app, configura la dirección de retorno y espera de 1 a 3 días hábiles. Si vendes en Xiaohongshu y quieres los pedidos y la posventa en tu ERP, usa la plataforma de comercio electrónico. Elige el desarrollo propio si tienes programadores, o busca un proveedor en el mercado de servicios. Si inviertes en anuncios y quieres informes masivos, pide a tu comercial que active la API de marketing. Ninguno de estos tres trabajos necesita a un tercero.

Si tu trabajo es observar a otros, las puertas oficiales no ayudan hoy. Eso incluye contar las notas y la interacción de la competencia, saber qué dice la gente sobre un tema o un destino, ver qué productos se recomiendan y seguir la imagen de una marca. Te quedan un script o una API de terceros. Para trabajos pequeños, puntuales o de aprendizaje, un script de código abierto basta: usa una cuenta que puedas perder y lee la licencia. Para una tarea diaria, una entrega a un cliente o un cliente de IA que llame a los datos por sí solo, una API de pago por llamada da menos trabajo. Mantén bajo el volumen con los hábitos de la sección «Cómo llamar menos» y sigue las prácticas de la sección de cumplimiento.

Para el turismo español esto es especialmente útil. Xiaohongshu publicó el 27 de octubre de 2026 que el 80 % de sus usuarios busca en la app antes de viajar (Guandian). Es decir, las notas sobre Barcelona, Madrid o Sevilla son una encuesta abierta a viajeros chinos. Dos artículos relacionados van más allá. Exportación de datos de Xiaohongshu y análisis de instantáneas explica cómo guardar búsquedas y comentarios como instantáneas. Comentarios de Xiaohongshu en lote da los pasos completos para bajar comentarios en lote.

Novedades del sector, octubre y noviembre de 2026

• 3 de noviembre de 2026: un día antes de nuestra muestra, MediaCrawler, xiaohongshu-mcp y XiaohongshuSkills tenían cambios nuevos, con 11, 35 y 32 cambios en los últimos 30 días. ReaJason/xhs sigue parado desde el 1 de julio de 2025 (API de GitHub, leída a las 00:19:50 del 4 de noviembre, hora de Singapur). Qué significa: las herramientas vivas cambian sin parar y hay que actualizar con ellas; las paradas no sirven para una tarea programada.
• 23 de octubre de 2026: el vídeo más visto de nuestra búsqueda de Barcelona, sobre el coste de un día en la ciudad, se publicó ese día y en 12 días sumó 5312 me gusta y 301 comentarios (datos de nuestra llamada de las 00:18 del 4 de noviembre, hora de Singapur). Qué significa: una sola nota puede marcar la conversación sobre un destino en dos semanas, así que conviene revisar cada semana.
• 21 a 23 de octubre de 2026: xiaohongshu-mcp recibió en la misma semana incidencias de «no puedo iniciar sesión» y «búsqueda limitada». El 1 de noviembre el autor integró correcciones para la espera de la búsqueda y para la publicación, y el 3 de noviembre otra para limpiar el navegador tras un fallo de sesión (historial de cambios). Qué significa: las herramientas que dependen de una sesión necesitan cambios cada pocas semanas, así que una tarea programada necesita una alerta de fallo.
• 17 de octubre de 2026: la web cambió el formato de sus datos de servidor y XHS-Downloader, con más de 13.000 estrellas, dejó de analizar notas hasta una corrección (incidencia 497). Qué significa: un cambio de página en un día cualquiera puede parar todos los scripts que leen esa página.
• 19 de agosto de 2026: se actualizó la referencia de la API de la plataforma de cuentas, y solo basic_info sigue abierto (referencia de la API). Qué significa: no cuentes con una API oficial para leer notas a corto plazo.

Primeros pasos: de una llamada de prueba a una tarea semanal

Paso uno: regístrate en EveryInfra y crea una clave de API. No hay cuota mensual y el saldo que recargas no caduca. Los pasos están en el inicio rápido. Paso dos: lee el catálogo gratuito y prueba una llamada en la página de una acción. Para notas tienes búsqueda, detalle de nota y notas de una cuenta. Para comentarios tienes comentarios, comentarios en lote y respuestas. Para tiendas, búsqueda de productos.

Paso tres: mira charged_usd y el número de filas de la respuesta y calcula tu precio por cada 1.000 filas con «cobro ÷ filas × 1.000». Luego usa la tabla de la sección «Cómo llamar menos» para estimar un mes. Paso cuatro: añade el bloque MCP a tu cliente de IA y pídele que revise tus palabras clave una vez por semana. Las demás plataformas están en el mercado de datos y el estado del servicio en la página de estado.

Preguntas frecuentes

¿Tiene Xiaohongshu una API oficial?

Esta pregunta sale de sugerencias de búsqueda como «xiaohongshu api documentation» y «rednote api documentation». Sí, pero solo para lo tuyo. La plataforma de cuentas solo abre basic_info (apodo, avatar, género y región). La de comercio electrónico permite a empresas y proveedores leer pedidos y productos de las tiendas que los autorizan. La de anuncios da a los anunciantes sus propios informes (lista de permisos, autorización de tiendas). No hay una API oficial que lea notas o comentarios públicos de otros, y read_notes sigue «planificado».

¿Cómo consigo una clave de API de Xiaohongshu?

Esta pregunta sale de las sugerencias «xiaohongshu api key» y «rednote api key». No existe una única «clave de API» oficial. En la plataforma de cuentas creas una app y recibes un app id y un secreto; la revisión dura entre 1 y 3 días hábiles (inicio rápido). En la de comercio electrónico, una empresa verificada recibe appId y appSecret, y después la cuenta principal de la tienda debe autorizarla. En la de anuncios, un comercial inicia el registro. Si lo que necesitas es una clave para leer notas públicas, es la clave de un servicio de terceros; en EveryInfra la creas en la consola tras registrarte.

¿Puedo usar en un producto comercial un script de Xiaohongshu de GitHub?

Esta pregunta sale de la sugerencia «xiaohongshu api github». Mira la licencia. En nuestra muestra de nueve, la licencia de MediaCrawler solo permite el aprendizaje no comercial y prohíbe el rastreo a gran escala (licencia). Spider_XHS y xiaohongshu-cli no declaran licencia, así que sus autores conservan todos los derechos. xiaohongshu-mcp usa Apache-2.0 y XHS-Downloader usa GPL-3.0. La licencia cubre el código, no los datos que recoges con él. Esos datos siguen sujetos a los términos de la plataforma y a la ley.

¿Funciona una cuenta RedNote con los scripts de Xiaohongshu?

Esta pregunta sale de las sugerencias «rednote xiaohongshu api» y «rednote api github». A menudo no. La incidencia #579 de xiaohongshu-mcp explica el cambio. Las cuentas creadas con un teléfono no chino después del 8 de diciembre de 2025 son cuentas RedNote, su sesión web pasa a rednote.com y cambia el dominio de la cookie. Los scripts que solo leen cookies de xiaohongshu.com dicen «sin sesión». Además, los usuarios de RedNote siguen otros términos, en vigor desde el 9 de junio de 2026, que prohíben la extracción automática (términos de RedNote).

¿Cómo se suele fijar el precio de una API de Xiaohongshu?

Esta pregunta sale de las sugerencias «xiaohongshu api pricing» y «xiaohongshu api pricing reddit». Las puertas oficiales no publican tarifas por la API. Los servicios de terceros suelen cobrar por petición, por fila o por créditos, y algunos añaden una cuota mensual. Convierte cada precio a precio por cada 1.000 filas con la fórmula de la sección sobre comparar precios antes de comparar. En EveryInfra, 16 de las 17 acciones de Xiaohongshu cuestan 0,005556 USD por llamada. En nuestra prueba eso fue 0,278 USD por cada 1.000 notas de búsqueda y 0,370 USD por cada 1.000 comentarios (catálogo).

Referencias

1. Portada del portal para desarrolladores, plataforma abierta de Xiaohongshu, leída el 2026-11-04. https://openaccount.xiaohongshu.com/
2. Lista de permisos (scope), plataforma abierta de Xiaohongshu, actualizada el 2026-03-29, captura del 2026-11-04. https://openaccount.xiaohongshu.com/docs/scope
3. Referencia de la API, plataforma abierta de Xiaohongshu, actualizada el 2026-08-19. https://openaccount.xiaohongshu.com/docs/api-reference
4. Inicio rápido, plataforma abierta de Xiaohongshu, actualizado el 2026-03-29. https://openaccount.xiaohongshu.com/docs/quick-start
5. Flujo de autorización para proveedores de software, plataforma de comercio electrónico de Xiaohongshu. https://open.xiaohongshu.com/document/developer/file/38
6. Método de firma, plataforma de comercio electrónico de Xiaohongshu. https://open.xiaohongshu.com/document/developer/file/39
7. Índice de documentación para desarrolladores, plataforma de comercio electrónico de Xiaohongshu. https://open.xiaohongshu.com/document/developer/file/4
8. Guía de perfiles de desarrollador, copia de terceros de la documentación de comercio electrónico. https://xiaohongshu.apifox.cn/doc-2811119
9. Guía de inicio de la API de marketing, plataforma de anuncios de Xiaohongshu, actualizada el 2024-01-03. https://ad.xiaohongshu.com/openApiDoc?categoryId=761&articleId=3047
10. Portada de la plataforma para compartir, Xiaohongshu. https://agora.xiaohongshu.com/index
11. Mensaje del foro sobre la pausa de la plataforma para compartir, V2EX, 2025-11-06. https://global.v2ex.co/t/1170874
12. Plataforma de miniprogramas, Xiaohongshu. https://miniapp.xiaohongshu.com/
13. Acuerdo de usuario de Xiaohongshu, actualizado el 2026-03-23. https://agree.xiaohongshu.com/h5/terms/ZXXY20220331001/-1
14. Términos de servicio de RedNote, en vigor desde el 2026-06-09. https://agree.xiaohongshu.com/h5/terms/ZXXY20251205003/-1
15. NanmiCoder/MediaCrawler, GitHub, leído el 2026-11-04. https://github.com/NanmiCoder/MediaCrawler
16. Licencia NON-COMMERCIAL LEARNING LICENSE 1.1 de MediaCrawler, GitHub. https://github.com/NanmiCoder/MediaCrawler/blob/main/LICENSE
17. xpzouying/xiaohongshu-mcp, GitHub. https://github.com/xpzouying/xiaohongshu-mcp
18. Historial de cambios de xiaohongshu-mcp, GitHub. https://github.com/xpzouying/xiaohongshu-mcp/commits/main
19. Incidencia 880 de xiaohongshu-mcp, no puedo iniciar sesión, 2026-10-23. https://github.com/xpzouying/xiaohongshu-mcp/issues/880
20. Incidencia 877 de xiaohongshu-mcp, búsqueda limitada, 2026-10-21. https://github.com/xpzouying/xiaohongshu-mcp/issues/877
21. Incidencia 878 de xiaohongshu-mcp, ¿lo permite la plataforma?, 2026-10-22. https://github.com/xpzouying/xiaohongshu-mcp/issues/878
22. Incidencia 579 de xiaohongshu-mcp, soporte para usuarios de rednote.com, 2026-03-13. https://github.com/xpzouying/xiaohongshu-mcp/issues/579
23. JoeanAmier/XHS-Downloader, GitHub. https://github.com/JoeanAmier/XHS-Downloader
24. Incidencia 497 de XHS-Downloader, fallo al analizar los datos del servidor, 2026-10-17. https://github.com/JoeanAmier/XHS-Downloader/issues/497
25. Incidencia 479 de XHS-Downloader, ajuste de velocidad de rastreo, 2026-09-15. https://github.com/JoeanAmier/XHS-Downloader/issues/479
26. cv-cat/Spider_XHS, GitHub. https://github.com/cv-cat/Spider_XHS
27. Incidencia 191 de Spider_XHS, cookie no válida o caducada, 2026-10-10. https://github.com/cv-cat/Spider_XHS/issues/191
28. jackwener/xiaohongshu-cli, GitHub. https://github.com/jackwener/xiaohongshu-cli
29. Incidencia 82 de xiaohongshu-cli, nuevo inicio de sesión cada 7 días, 2026-08-17. https://github.com/jackwener/xiaohongshu-cli/issues/82
30. ReaJason/xhs, GitHub. https://github.com/ReaJason/xhs
31. white0dew/XiaohongshuSkills, GitHub. https://github.com/white0dew/XiaohongshuSkills
32. autoclaw-cc/xiaohongshu-skills, GitHub. https://github.com/autoclaw-cc/xiaohongshu-skills
33. Jamailar/Beav, GitHub. https://github.com/Jamailar/Beav
34. Cloxl/xhshow, biblioteca de firmas de peticiones, GitHub. https://github.com/Cloxl/xhshow
35. List repository issues, documentación de la API REST de GitHub. https://docs.github.com/en/rest/issues/issues#list-repository-issues
36. Licensing a repository, documentación de GitHub. https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository
37. Ley de Protección de Información Personal de la República Popular China, Administración del Ciberespacio de China. https://www.cac.gov.cn/2021-08/20/c_1631050028355286.htm
38. Reglamento de Gestión de la Seguridad de los Datos de Red (Orden 790 del Consejo de Estado), copia del Ministerio de Ecología y Medio Ambiente. https://www.mee.gov.cn/zcwj/gwywj/202410/t20241003_1087417.shtml
39. Publicación del Reglamento de Gestión de la Seguridad de los Datos de Red, Ministerio de Justicia, 2024-09-30. https://www.moj.gov.cn/pub/sfbgw/gwxw/xwyw/202409/t20240930_507076.html
40. Ley contra la Competencia Desleal de la República Popular China, reforma de 2025, Administración Nacional de Propiedad Intelectual. https://www.cnipa.gov.cn/art/2026/5/20/art_104_206437.html
41. Informe de datos de viajes de Xiaohongshu, Guandian, 2026-10-27. https://www.guandian.cn/m/show/618758
42. Catálogo de datos sociales de EveryInfra (lectura gratuita), leído el 2026-11-04 a las 00:13, hora de Singapur. https://api.everyinfra.com/api/v1/social/catalog
43. Especificación del Model Context Protocol 2025-06-18. https://modelcontextprotocol.io/specification/2025-06-18