API de Xiaohongshu
Busca notas y cuentas, y consulta perfiles, publicaciones, temas, comentarios, respuestas y tendencias públicas de Xiaohongshu. El ID de usuario, la URL y el comment ID identifican objetos distintos.
Likes, guardados, compartidos y ubicación mostrada son campos públicos, no intención de compra o identidad. Los lotes pueden ser parciales y no incluyen contenido privado.
Disponibilidad de la plataforma
- Salud 24 h
- 99 %
Últimos 30 días
Funciones disponibles
Cada acción de Xiaohongshu, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar notas en Xiaohongshusearch | Busca notas de Xiaohongshu mediante keyword, con tipo y orden opcionales. | $5.56 por 1.000 solicitudes | Saludable · salud 100 % |
Consultar un perfil de Xiaohongshuprofile | Consulta una cuenta por user_id y recoge Red ID, biografía, verificación y contadores públicos, con seguidores exactos. | $5.56 por 1.000 solicitudes | Saludable · salud 100 % |
Listar notas de una cuentauser_posts | Obtiene notas públicas del user_id, con las fijadas primero y el resto de la más reciente a la más antigua. | $5.56 por 1.000 solicitudes | Normal |
Consultar una nota concretanote | Abre la url de una nota y devuelve texto, autor, ubicación IP mostrada y métricas. | $5.56 por 1.000 solicitudes | Saludable · salud 100 % |
Obtener el vídeo de una notavideo | Obtiene la URL de reproducción de una nota de vídeo mediante su url (la misma que acepta note). | $5.56 por 1.000 solicitudes | Normal |
Leer comentarios de una notacomments | Lee comentarios de la url de una nota y conserva autor, ubicación mostrada y subcomentarios contados. | $5.56 por 1.000 solicitudes | Saludable · salud 96 % |
Leer comentarios de varias notascomments_batch | Procesa varias URL en urls para devolver comentarios por nota. | $5.56 por 1.000 solicitudes | Saludable · salud 90 % |
Leer respuestas de un comentariosub_comments | Obtiene respuestas de comment_id dentro de la url de una nota. | $5.56 por 1.000 solicitudes | Normal |
Buscar cuentas de Xiaohongshusearch_users | Encuentra cuentas de creadores y marcas por keyword, con filtros opcionales por seguidores y tipo de cuenta. | $5.56 por 1.000 solicitudes | Normal |
Leer notas de un temahashtag | Lee las notas públicas de una página de tema mediante topic_id, primero las más recientes o las más populares. | $5.56 por 1.000 solicitudes | Normal |
Explorar notas en tendenciatrending | Consulta una muestra de las notas que Xiaohongshu recomienda en este momento, sin parámetros de entrada. | $5.56 por 1.000 solicitudes | Disponible · salud 76 % |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Xiaohongshu?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar notas en Xiaohongshu Busca notas de Xiaohongshu mediante | keyword | content_type, date_range, page_token, sort | Entrega síncrona | Cada llamada devuelve una página de hasta 20 filas; para la siguiente, envía como page_token el next_page_token del nivel superior de la respuesta. limit se acepta y no tiene efecto. | $5.56 por 1.000 solicitudes | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · next_page_token · video_url · duration_sec · duration_seconds · platform · poi_id · poi_name · images · is_goods_note · author_is_verified |
profileConsultar un perfil de Xiaohongshu Consulta una cuenta por | user_id | — | Entrega síncrona | — | $5.56 por 1.000 solicitudes | 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 |
user_postsListar notas de una cuenta Obtiene notas públicas del | user_id | page_token | Entrega síncrona | Cada llamada devuelve una página de hasta 20 filas; para la siguiente, envía como page_token el next_page_token del nivel superior de la respuesta. limit se acepta y no tiene efecto. | $5.56 por 1.000 solicitudes | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · next_page_token · video_url · duration_sec · duration_seconds · platform · images · is_goods_note · is_pinned · ip_location |
noteConsultar una nota concreta Abre la | url | — | Entrega síncrona | — | $5.56 por 1.000 solicitudes | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · ip_location · author_name · author_id · is_video · avatar_url · author_url · platform · images · tags · topics · mentioned_users · lat · lng · has_goods · author_red_id · author_is_verified · language |
videoObtener el vídeo de una nota Obtiene la URL de reproducción de una nota de vídeo mediante su | url | — | Entrega síncrona | — | $5.56 por 1.000 solicitudes | id · url · video_url · duration_sec · duration_seconds · platform |
commentsLeer comentarios de una nota Lee comentarios de la | url | page_token, sort | Entrega síncrona | Cada llamada devuelve una página de hasta 15 filas; para la siguiente, envía como page_token el next_page_token del nivel superior de la respuesta. limit se acepta y no tiene efecto. | $5.56 por 1.000 solicitudes | id · text · like_count · posted_at · ip_location · author_name · author_id · sub_comment_count · note_id · note_url · next_page_token · images · is_author · author_avatar_url · author_red_id · author_is_ai_agent · mentioned_users · platform |
comments_batchLeer comentarios de varias notas Procesa varias URL en | urls | sort | Entrega síncrona | Para cada nota, cada llamada devuelve una página de hasta 15 comentarios, sin next_page_token; para seguir leyendo, pagina cada nota por separado con comments. Una llamada admite entre 1 y 20 valores en urls. limit se acepta y no tiene efecto. | $5.56 por 1.000 solicitudes | id · text · like_count · posted_at · ip_location · author_name · author_id · sub_comment_count · note_id · note_url · next_page_token · images · is_author · author_avatar_url · author_red_id · author_is_ai_agent · mentioned_users · platform |
sub_commentsLeer respuestas de un comentario Obtiene respuestas de | url, comment_id | page_token | Entrega síncrona | Cada llamada devuelve una página de hasta 10 filas; para la siguiente, envía como page_token el next_page_token del nivel superior de la respuesta. limit se acepta y no tiene efecto. | $5.56 por 1.000 solicitudes | id · text · like_count · posted_at · ip_location · author_name · author_id · reply_to_id · reply_to_author_name · reply_to_author_id · next_page_token · images · is_author · author_avatar_url · author_red_id · author_is_ai_agent · mentioned_users · platform |
search_usersBuscar cuentas de Xiaohongshu Encuentra cuentas de creadores y marcas por | keyword | follower_range, page_token, user_type | Entrega síncrona | Cada llamada devuelve una página de hasta 20 filas; para la siguiente, envía como page_token el next_page_token del nivel superior de la respuesta. limit se acepta y no tiene efecto. | $5.56 por 1.000 solicitudes | user_id · nickname · red_id · avatar_url · url · follower_count · is_verified · verification_type · next_page_token · platform |
hashtagLeer notas de un tema Lee las notas públicas de una página de tema mediante | topic_id | page_token, sort | Entrega síncrona | Cada llamada devuelve una página de hasta 20 filas. El número de filas varía de una página a otra, así que una página corta no significa que haya terminado. Para la siguiente, envía como page_token el next_page_token del nivel superior de la respuesta; cuando no haya ninguno, no hay más páginas. limit se acepta y no tiene efecto. | $5.56 por 1.000 solicitudes | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · next_page_token · video_url · duration_sec · duration_seconds · platform · images |
trendingExplorar notas en tendencia Consulta una muestra de las notas que Xiaohongshu recomienda en este momento, sin parámetros de entrada. La selección cambia en cada carga; la posición en la lista no explica el algoritmo ni crea historial. | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 30 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $5.56 por 1.000 solicitudes | id · url · title · author_name · is_video · image_url · platform |
¿Qué significan los parámetros de Xiaohongshu search?
Busca notas de Xiaohongshu mediante keyword, con tipo y orden opcionales. Devuelve título, autor e interacciones visibles; no calcula intención de compra ni cobertura total.
keywordObligatorio- Término para buscar en el contenido de las notas de Xiaohongshu, como «protector solar piel sensible». No busca por ID de usuario.
content_typeOpcional- Filtra las notas devueltas por tipo, como imagen y texto o vídeo. Usa los valores permitidos para la acción seleccionada.Valores permitidos:
allimagevideoXiaohongshu: nota de imagen, nota de vídeo y comentarios — La documentación pública de los enlaces profundos distingue notas con imágenes, notas de vídeo y la vista de comentarios. Aclara los objetos de contenido; sus parámetros de salto de aplicación no son entradas de EveryInfra. · Consultada date_rangeOpcional- Filtra las notas por fecha de publicación:
last_24_hours(últimas 24 horas) olast_7_days(últimos 7 días); si no lo envías, no hay límite. Mantén el mismo valor al paginar.Valores permitidos:last_24_hourslast_7_days page_tokenOpcional- Cursor de paginación para las acciones comments, sub_comments, search, user_posts, search_users y hashtag: devuelve el valor next_page_token de una fila de la respuesta anterior para obtener la siguiente página; omítelo para empezar desde la primera página. Cada página es una llamada y se factura por solicitud.
sortOpcional- Criterio de orden de las listas de notas en
search. Valores posibles:relevance(relevancia),newest(más reciente),most_liked(con más «me gusta»),most_commented(con más comentarios) ymost_collected(con más guardados). Usa solo los valores permitidos que se indican para la acción.Valores permitidos:most_collectedmost_commentedmost_likednewestrelevance
¿Qué significan los parámetros de Xiaohongshu profile?
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.
user_idObligatorio- 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 elauthor_idque devuelven las acciones de comentarios. Se usa para obtener los datos de la cuenta o sus notas publicadas. No es el apodo.
¿Qué significan los parámetros de Xiaohongshu user_posts?
Obtiene notas públicas del user_id, con las fijadas primero y el resto de la más reciente a la más antigua. El lote no garantiza todo el historial ni contenido privado o eliminado.
user_idObligatorio- 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 elauthor_idque devuelven las acciones de comentarios. Se usa para obtener los datos de la cuenta o sus notas publicadas. No es el apodo. page_tokenOpcional- Cursor de paginación para las acciones comments, sub_comments, search, user_posts, search_users y hashtag: devuelve el valor next_page_token de una fila de la respuesta anterior para obtener la siguiente página; omítelo para empezar desde la primera página. Cada página es una llamada y se factura por solicitud.
¿Qué significan los parámetros de Xiaohongshu note?
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.
urlObligatorio- 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 comoxsec_token. La acciónsub_commentstambién requiere elcomment_idde un comentario de la misma nota.
¿Qué significan los parámetros de Xiaohongshu video?
Obtiene la URL de reproducción de una nota de vídeo mediante su url (la misma que acepta note). El detalle de la nota no incluye la URL de reproducción (desde 2026-10-14): llama a esta acción aparte cuando la necesites. Devuelve id, url, video_url, duration_sec y platform; la URL va firmada y caduca, descárgala pronto. Las notas de imágenes devuelven vacío y se reembolsan.
urlObligatorio- 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 comoxsec_token. La acciónsub_commentstambién requiere elcomment_idde un comentario de la misma nota.
¿Qué significan los parámetros de Xiaohongshu comments?
Lee comentarios de la url de una nota y conserva autor, ubicación mostrada y subcomentarios contados. No garantiza el árbol completo ni publica respuestas.
urlObligatorio- 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 comoxsec_token. La acciónsub_commentstambién requiere elcomment_idde un comentario de la misma nota. page_tokenOpcional- Cursor de paginación para las acciones comments, sub_comments, search, user_posts, search_users y hashtag: devuelve el valor next_page_token de una fila de la respuesta anterior para obtener la siguiente página; omítelo para empezar desde la primera página. Cada página es una llamada y se factura por solicitud.
sortOpcional- Orden de los comentarios:
defaultsigue el orden propio de la plataforma (igual que no enviarlo),newestmuestra primero los más recientes ymost_liked, los que tienen más «me gusta». Mantén el mismo valor al paginar; si lo cambias, elnext_page_tokenanterior deja de servir.Valores permitidos:defaultmost_likednewest
¿Qué significan los parámetros de Xiaohongshu comments_batch?
Procesa varias URL en urls para devolver comentarios por nota. Cada fila conserva su note_id y note_url; no debe mezclarse la conversación entre notas.
urlsObligatorio- Array con los enlaces de las notas para la acción
comments_batch. Puedes enviar de 1 a 20 enlaces por llamada. Cada uno debe incluir el ID de la nota y unxsec_tokenválido. El coste se calcula según el número de notas solicitadas. Si algunas solicitudes fallan, comprueba los campospartialomisseden la respuesta. No asumas que una nota no devuelta significa que no tiene comentarios. sortOpcional- Orden de los comentarios de cada nota de la solicitud:
defaultsigue el orden propio de la plataforma (igual que no enviarlo),newestmuestra primero los más recientes ymost_liked, los que tienen más «me gusta».Valores permitidos:defaultmost_likednewest
¿Qué significan los parámetros de Xiaohongshu sub_comments?
Obtiene respuestas de comment_id dentro de la url de una nota. Distingue reply_to_id cuando existe; no expande otros comentarios ni garantiza toda la rama.
urlObligatorio- 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 comoxsec_token. La acciónsub_commentstambién requiere elcomment_idde un comentario de la misma nota. comment_idObligatorio- ID del comentario principal cuyas respuestas quieres obtener. Debes obtenerlo de los resultados de la acción
commentspara la misma nota y usarlo junto con laurlcorrespondiente. No es el ID de la nota ni el ID del autor del comentario. page_tokenOpcional- Cursor de paginación para las acciones comments, sub_comments, search, user_posts, search_users y hashtag: devuelve el valor next_page_token de una fila de la respuesta anterior para obtener la siguiente página; omítelo para empezar desde la primera página. Cada página es una llamada y se factura por solicitud.
¿Qué significan los parámetros de Xiaohongshu search_users?
Encuentra cuentas de creadores y marcas por keyword, con filtros opcionales por seguidores y tipo de cuenta. El número de seguidores es aproximado y el user_id sirve para profile y user_posts.
keywordObligatorio- Palabra clave para encontrar cuentas, como café, el nombre de una marca o un tema. Devuelve usuarios (creadores y cuentas de marca), no notas.
follower_rangeOpcional- Filtra las cuentas de
search_userspor número de seguidores:under_100(menos de 100),100_to_1k(de 100 a 1000),1k_to_10k(de 1000 a 10 000),10k_to_100k(de 10 000 a 100 000) uover_100k(más de 100 000). Si no lo envías, no hay límite.Valores permitidos:100_to_1k10k_to_100k1k_to_10kover_100kunder_100 page_tokenOpcional- Cursor de paginación para las acciones comments, sub_comments, search, user_posts, search_users y hashtag: devuelve el valor next_page_token de una fila de la respuesta anterior para obtener la siguiente página; omítelo para empezar desde la primera página. Cada página es una llamada y se factura por solicitud.
user_typeOpcional- Filtra las cuentas de
search_userspor tipo:general(usuario normal),verified_individual(persona verificada) obusiness(empresa verificada). Si no lo envías, no hay límite.Valores permitidos:businessgeneralverified_individual
¿Qué significan los parámetros de Xiaohongshu hashtag?
Lee las notas públicas de una página de tema mediante topic_id, primero las más recientes o las más populares. Incluye texto completo, imágenes y datos del vídeo; una página no equivale a todo el tema.
topic_idObligatorio- ID de la página de tema para
hashtag(24 caracteres) o un enlace a esa página, comohttps://www.xiaohongshu.com/page/topics/<ID>, un enlace de tema de la app o un enlace corto de Xiaohongshu. Sirven directamente los valorestopics[].topic_idque devuelvenote. No es el ID del objeto de etiqueta de una nota ni el nombre del tema. page_tokenOpcional- Cursor de paginación para las acciones comments, sub_comments, search, user_posts, search_users y hashtag: devuelve el valor next_page_token de una fila de la respuesta anterior para obtener la siguiente página; omítelo para empezar desde la primera página. Cada página es una llamada y se factura por solicitud.
sortOpcional- Orden de las notas del tema:
newestmuestra primero las más recientes (igual que no enviarlo) ypopular, las más populares. Mantén el mismo valor al paginar.Valores permitidos:newestpopular
¿Qué significan los parámetros de Xiaohongshu trending?
Consulta una muestra de las notas que Xiaohongshu recomienda en este momento, sin parámetros de entrada. La selección cambia en cada carga; la posición en la lista no explica el algoritmo ni crea historial.
Referencia completa: parámetros, ejemplos de código, respuesta de ejemplo y salud →Esta acción no tiene parámetros de negocio. Envía únicamente los identificadores de plataforma y acción.
Cómo usar la API de Xiaohongshu
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"xiaohongshu","action":"search","params":{"keyword":"<keyword>"}}'
Guías de Xiaohongshu
Ejemplos completos y métodos basados en estas acciones. Comprueba primero en esta página las acciones, parámetros y campos actuales; los ejemplos y límites de un artículo no sustituyen al catálogo en vivo.
Cómo obtener comentarios de Xiaohongshu por lotes: de la lista de notas al resultado verificable
Integra paso a paso comments_batch de Xiaohongshu: prepara enlaces de notas completos, diferencia entre número de URLs y cantidad de comentarios, identifica partial y missed, deduplica por nota, y maneja resultados vacíos, reintentos y facturación por objetivo.
Leer el artículo →Análisis de datos en Xiaohongshu: cómo usar la exportación de notas y las instantáneas históricas
A partir de la práctica de exportación de datos por parte de creadores, comprende los valores acumulados e intervalos, las fechas de instantáneas, los incrementos de favoritos, la deduplicación y las muestras faltantes para evitar comparar periodos y notas diferentes.
Leer el artículo →Inicio con la API de datos unificada: del directorio de capacidades al primer resultado disponible
Integra datos multiplataforma usando platform, action y params: comprende el directorio de capacidades, completa una solicitud mínima, gestiona tareas asíncronas, resultados parciales y facturación, y establece registros de datos trazables.
Leer el artículo →Preguntas sobre la API de Xiaohongshu
¿Cómo llamo a la API de Xiaohongshu?
Envía POST /api/v1/social con platform igual a xiaohongshu, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Xiaohongshu?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, text, like_count y collect_count. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Xiaohongshu?
La documentación pública de los enlaces profundos distingue notas con imágenes, notas de vídeo y la vista de comentarios. Aclara los objetos de contenido; sus parámetros de salto de aplicación no son entradas de EveryInfra.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere user_id; user_posts requiere user_id; consulta las demás acciones en la lista de funciones.
¿Las acciones de Xiaohongshu responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. comments_batch solo funciona en modo síncrono: lee todo lo que devuelve (cada elemento de un lote o cada SKU de un producto) en la misma llamada y, si la solicitud lleva "mode": "async", la API responde con un 422 antes de cobrar nada. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.