API de redes sociales
Rednote API
Lee notas de Rednote, perfiles, comentarios anidados, búsquedas, palabras clave en tendencia, el feed principal y listados de productos con reseñas, todo como JSON estructurado.
- Serie App V2 recomendada — la superficie más reciente, más estable y más completa
- Señales de tendencia de la plataforma que marca el gusto chino en belleza, moda y viajes
- Listados de productos, reseñas y comentarios con intención de compra para investigación de comercio electrónico
$0.05 de crédito gratis al registrarte · sin tarjeta · desde $0.01/petición
Una petición, JSON estructurado
1curl -X GET "https://api.tikhub.io/api/v1/xiaohongshu/app_v2/get_image_note_detail?note_id=65a1b2c3d4e5f60001234567" \2 -H "Authorization: Bearer YOUR_API_KEY"1{2 "code": 200,3 "data": {4 "note_id": "65a1b2c3d4e5f60001234567",5 "title": "示例笔记标题",6 "type": "normal",7 "interact_info": {8 "liked_count": 18400,9 "comment_count": 920,10 "collected_count": 7600,11 "share_count": 34012 },13 "user": { "user_id": "5f1a2b3c", "nickname": "用户昵称", "red_id": "xhs_id" },14 "image_list": [{ "url": "https://..." }],15 "tag_list": [{ "name": "美妆" }]16 }17}Consigue tu clave API en user.tikhub.io/dashboard/api — o sigue la guía de primeros pasos.
Qué incluye la API de Rednote
La Rednote API de TikHub lee la plataforma que define el gusto del consumidor chino en belleza, moda, gastronomía y viajes. Extrae detalles de notas, perfiles de usuario, comentarios anidados, resultados de búsqueda, palabras clave en tendencia, el feed principal y listados de productos con reseñas como JSON estructurado — empieza por la serie App V2 recomendada.
Rednote App V2 API (recomendada)
Rednote PGY API
Rednote Web V3 API
Las series heredadas App V1 (/xiaohongshu/app/), Web (/xiaohongshu/web/) y Web V2 están obsoletas. Construye sobre las tres series que se mantienen: App V2 (recomendada), PGY (marketing de creadores) y Web V3.
Donde se fija primero el gusto del consumidor chino
Rednote es donde nacen en China las tendencias de belleza, moda, gastronomía y viajes antes de llegar a occidente. TikHub te da sus superficies de app y web — incluidas las palabras clave en tendencia, el feed principal y los listados de productos con comentarios de intención de compra — para que leas la demanda en su origen, no en su eco.
Endpoints de la API de Rednote
Una referencia de los endpoints de Rednote más usados. Explora el conjunto completo en la referencia de la API o la documentación.
Rednote App V2 API (recomendada — estable)
App V2 es la opción recomendada por defecto — la serie más reciente, más estable y más completa, con productos, reseñas, temas y el feed de inspiración para creadores. Se factura a $0.01 por solicitud; cada respuesta incluye un cache_url válido durante 24 h (de acceso gratuito). Rednote es una serie especial — lee la guía de uso en blog.tikhub.io/zh/article/7 antes de integrarla.
Rednote PGY API (marketing de creadores)
PGY (蒲公英 / Pugongying) es la plataforma oficial de marketing con creadores de Rednote. Esta serie devuelve analíticas de bloggers — datos principales y resumidos, perfiles e histórico de fans, rendimiento de las notas y descubrimiento de bloggers —, los datos que las marcas usan para evaluar influencers antes de una campaña.
Rednote Web V3 API
Web V3 funciona como superficie alternativa — útil para las palabras clave en tendencia, las sugerencias de búsqueda y el feed de recomendaciones de la portada. Las series más antiguas Web V2 y Web ya no se mantienen; evítalas.
Consejos y resolución de problemas
Notas operativas ganadas a pulso para trabajar con datos de Rednote en producción.
LECTURA OBLIGATORIA — Rednote es una serie especial
Rednote (小红书) es la serie con más particularidades de TikHub, así que consulta la guía de uso oficial antes de usar CUALQUIER endpoint. En resumen: usa App V2 para contenido, PGY para analíticas de marketing de creadores y Web V3 para el feed principal y las tendencias. NO uses las series heredadas App V1 (/xiaohongshu/app/), Web ni Web V2 — están obsoletas.
Qué serie usar
App V2 es la opción recomendada por defecto — la serie más reciente, más estable y más completa (notas, usuarios, búsqueda, productos, temas, inspiración para creadores). PGY cubre las analíticas de marketing de creadores (datos de bloggers, perfiles de fans, rendimiento de notas) para evaluar influencers. Web V3 es la superficie alternativa para palabras clave en tendencia, sugerencias de búsqueda y el feed de portada. Las series heredadas App V1, Web y Web V2 están obsoletas — TikHub ya no las mantiene.
Endpoints obsoletos y retirados
Las series heredadas /xiaohongshu/app/ (App V1), /xiaohongshu/web/ y /xiaohongshu/web_v2/ están obsoletas — no construyas sobre ellas. Para el detalle de notas usa app_v2/get_image_note_detail o app_v2/get_video_note_detail; para la búsqueda usa app_v2/search_notes / app_v2/search_users (o sus equivalentes en Web V3). Las publicaciones de un tema y las notas por etiqueta se obtienen con app_v2/get_topic_feed; para el descubrimiento general, usa la búsqueda por palabra clave.
Precio y la URL de caché de 24 horas
Los endpoints de Rednote se facturan a $0.01 por solicitud (sin descuento por volumen salvo que superes 1M de solicitudes al mes), lo que refleja el costo de mantenimiento de un objetivo difícil. Cada solicitud devuelve datos frescos en tiempo real y se factura de forma independiente — TikHub nunca sirve datos en caché a través de la API. El cache_url de cada respuesta correcta es una ayuda de depuración aparte: vuelve a abrir esa respuesta exacta durante 24 horas (su acceso es gratuito) para que puedas recuperarla si tu código la manejó mal o compartirla con alguien del equipo. No es una forma más barata de volver a obtener la misma nota — una solicitud repetida es siempre una nueva llamada en vivo.
Lo que no está disponible: reproducciones y descargas
Rednote no expone el número de reproducciones (播放量) ni el de descargas, así que TikHub no puede devolverlos — la propia plataforma no muestra esas métricas. Sí puedes obtener el contenido de las notas, imágenes, videos, perfiles de usuario, comentarios, me gusta (点赞), veces compartidas (分享) y resultados de búsqueda. Ten en cuenta también que no hay obtención por lotes (las notas se recuperan de una en una) y que los tokens xsec ya no se devuelven.
Cómo tratar los errores 400 y la paginación
El backend de Rednote puede tardar en calentarse. Si una solicitud devuelve un 400, reinténtala unas cuantas veces; si sigue fallando, los recursos del backend se están cargando — espera entre 30 y 60 minutos y vuelve a intentarlo. Los endpoints paginados (notas de usuario, búsqueda) devuelven en torno a 6–20 elementos por solicitud, y la primera página puede devolver menos — sigue paginando con el cursor.
¿Rednote es lo mismo que Xiaohongshu (小红书)?
Sí — Rednote es el nombre internacional de 小红书 (Xiaohongshu), literalmente «librito rojo». Los endpoints de TikHub cubren la misma plataforma independientemente del nombre con el que la busques.
¿Es legal usar una API de Rednote como esta?
TikHub solo devuelve datos de Rednote disponibles públicamente — contenido que cualquier visitante puede ver sin cuenta. No elude la autenticación ni accede a información privada. Rednote es una plataforma china, por lo que las restricciones relevantes son sus propias condiciones de servicio y la normativa china de datos y de transferencias transfronterizas, más que la jurisprudencia estadounidense; el acceso automatizado puede derivar en bloqueos de cuenta o de IP, que la infraestructura de TikHub absorbe por ti. Tú sigues siendo responsable de cómo almacenes, trates y uses los datos — en especial cualquier dato personal y cualquier transferencia posterior a través de fronteras.
¿Cuál es el límite de velocidad?
El límite de velocidad por defecto es de 10 solicitudes por segundo. Los planes de RPS lo escalan hacia arriba — de 20 RPS por $5/mes a 100 RPS por $55/mes — y las cuentas enterprise obtienen límites personalizados por encima de 100 RPS.
¿Cuánto cuesta la Rednote API?
Los endpoints de Rednote se facturan a $0.01 por solicitud — no hay descuento por volumen salvo que superes 1M de solicitudes al mes, lo que refleja el costo de mantenimiento de una plataforma fuertemente protegida. Cada solicitud devuelve datos frescos en tiempo real y se factura de forma independiente; el cache_url de cada respuesta es una ayuda gratuita de depuración y de compartición que vuelve a abrir esa respuesta concreta durante 24 horas — no son datos de API en caché, así que una llamada repetida siempre obtiene datos en vivo. Las cuentas nuevas reciben $0.05 de crédito gratis — sin tarjeta de crédito.
Rednote API: lee la plataforma china de estilo de vida en 2026
La Rednote API de TikHub lee datos públicos de 小红书 — notas, perfiles, comentarios, búsqueda, palabras clave en tendencia, el feed principal y listados de productos — mediante simples llamadas REST, sin registro de desarrollador chino. Aquí tienes cómo funciona, por qué es más profunda que una extracción genérica y qué opción encaja con cada trabajo.
¿Cómo funciona la Rednote API?
¿Qué es la Rednote API?
La Rednote API de TikHub es una interfaz RESTful que devuelve JSON estructurado para contenido público de 小红书 (Rednote) — la plataforma que moldea el gusto del consumidor chino en belleza, moda, gastronomía y viajes. Solicitas una nota, un perfil, un hilo de comentarios, una búsqueda o una lista de tendencias y recibes datos limpios y tipados sin mantener tu propia infraestructura de datos contra una plataforma en chino y fuertemente protegida.
Abarca las series App V2, PGY y Web V3, incluidos el feed principal y las palabras clave en tendencia que revelan la demanda mientras se forma — señales a las que una extracción básica no llega.
¿Cómo se accede y se usa?
Crea una cuenta de TikHub, genera una clave de API y haz una solicitud HTTP GET con la clave en la cabecera Authorization. Identifica el contenido por ID de nota, ID de usuario o un término de búsqueda y recibes JSON — sin cuenta de desarrollador chino ni solicitud a la plataforma abierta. Un flujo habitual es seguir las palabras clave en tendencia, buscar las más calientes y después extraer el detalle de las notas y sus comentarios para los primeros resultados.
¿Qué ventajas tiene usar la Rednote API?
¿Por qué usarla en lugar de construir una infraestructura de datos?
Rednote es una de las plataformas más difíciles de recolectar — respuestas en chino, defensas anti-bot agresivas y endpoints que rotan con frecuencia. Montar eso y mantenerlo con vida supone un costo de ingeniería real y continuo. TikHub lo absorbe y ofrece las series App V2, PGY y Web V3 para que tu integración sobreviva a los cambios de la plataforma, exponiendo un contrato estable sobre el que construir a un precio por solicitud.
¿Quién se beneficia: marcas, investigadores o equipos de IA?
Las marcas y las agencias siguen las tendencias de belleza y moda en su origen, vigilan su reputación entre los consumidores chinos y analizan el contenido de KOLs y KOCs antes de contratar campañas. Los investigadores estudian el lenguaje de intención de compra y las tendencias por categoría. Los equipos de IA construyen corpus de estilo de vida chino y pipelines de sentimiento a partir de una fuente estructurada — la riqueza de imágenes y comentarios de las notas las hace especialmente útiles para el trabajo multimodal.
¿Cuáles son los casos de uso habituales de la Rednote API?
¿Cómo se usa para investigación de tendencias y comercio electrónico?
El patrón va de la tendencia al producto: observa las palabras clave en tendencia, búscalas y lee las notas principales y sus comentarios para entender tanto qué está subiendo como de qué forma hablan de ello los consumidores. Como las notas llevan asociaciones de producto, puedes conectar la interacción con productos concretos y seguir su recepción — convirtiendo Rednote en una fuente viva de demanda e inteligencia competitiva para las categorías de consumo chinas.
¿Cómo impulsa la IA y los modelos de contenido?
El texto estructurado de las notas, las imágenes y los hilos de comentarios alimentan modelos de sentimiento, sistemas de predicción de tendencias y pipelines de recuperación sobre contenido chino de estilo de vida. El lenguaje de intención de compra de los comentarios es una señal de entrenamiento valiosa para la IA de comercio electrónico y de recomendación, y el feed principal ofrece una ventana a lo que la propia plataforma está destacando.
¿Existen alternativas a la Rednote API?
¿Qué otras opciones existen y cuál es la mejor?
La plataforma abierta oficial de Rednote es limitada y está condicionada a un registro mercantil chino; existen algunas herramientas de código abierto, pero cargan con la habitual carga de fiabilidad y mantenimiento frente a un objetivo difícil, y la mayoría de los proveedores occidentales no la cubren con profundidad. Para equipos no chinos que necesitan profundidad real — tendencias, feed principal, productos y comentarios —, una API gestionada como TikHub es la opción práctica, con una sola clave que cubre además Douyin y otras 14 plataformas.
Una clave, todas las plataformas
La API de Rednote comparte su clave y su formato JSON con otras 15 plataformas — añadir Instagram o Douyin es un cambio de una línea.