API de plataforma de EveryData
API de Xiaohongshu
Busca notas y consulta perfiles, publicaciones, comentarios, respuestas y tendencias públicas de Xiaohongshu. ID de usuario, URL y comment ID conservan objetos diferentes.
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.
- Endpoint
- POST /api/v1/social
- Funciones
- 8
- Por 1.000
- 5,556 US$
Funciones disponibles
Compara las acciones de Xiaohongshu por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| 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, sort | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 50` 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 · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · platform |
profileConsultar un perfil de Xiaohongshu Consulta una cuenta por | user_id | content_type, min_likes, sort | 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 · platform |
user_postsListar notas de una cuenta Obtiene notas públicas del | user_id | content_type, min_likes, sort | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 100` 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 · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · platform |
noteConsultar una nota concreta Abre la | url | content_type, sort | 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 · platform |
commentsLeer comentarios de una nota Lee comentarios de la | url | content_type, sort | Entrega síncrona | El catálogo declara `defaultLimit = 30` y `maxLimit = 200` 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 · text · like_count · posted_at · ip_location · author_name · author_id · sub_comment_count · note_id · note_url · platform |
comments_batchLeer comentarios de varias notas Procesa varias URL en | urls | — | Entrega síncrona | Para cada nota, el catálogo declara `defaultLimit = 30` y `maxLimit = 200`. Una llamada admite entre 1 y 20 valores en `urls`; estos límites no son el máximo total de comentarios de toda la solicitud. | $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 · platform |
sub_commentsLeer respuestas de un comentario Obtiene respuestas de | url, comment_id | content_type, sort | Entrega síncrona | El catálogo declara `defaultLimit = 10` 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 · text · like_count · posted_at · ip_location · author_name · author_id · reply_to_id · platform |
trendingExplorar notas en tendencia Consulta una selección de notas en tendencia sin entrada obligatoria y admite tipo, periodo u orden. La posición observada no explica el algoritmo ni crea historial. | content_type, date_range, sort | 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é 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.
¿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- Filtro por tipo de nota. Usa
alloall_typespara no filtrar,imageoimage_notes_onlypara notas con imagen y texto,video,videos_onlyovideo_notes_onlypara notas de vídeo, ylive_notes_onlypara notas de directos. Usa solo los valores permitidos listados para esta API.Valores permitidos:allimagevideoXiaohongshu: nota de imagen, nota de vídeo y comentariosLa documentación pública de deeplinks 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 sortOpcional- Criterio de orden para notas o comentarios. Valores posibles:
relevance(relevancia),newest(más reciente),popular(popularidad),most_liked(con más «me gusta»),most_commented(con más comentarios),most_collected(con más guardados). Comprueba los valores permitidos para cada acción, ya que no todos son compatibles. No uses los criterios de orden de búsqueda en las acciones de comentarios.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 y contadores públicos. Los filtros compatibles no revelan audiencia privada ni convierten la ficha en búsqueda de notas.
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. Se usa para obtener los datos de la cuenta o sus notas publicadas. No es el apodo. content_typeOpcional- Filtro por tipo de nota. Usa
alloall_typespara no filtrar,imageoimage_notes_onlypara notas con imagen y texto,video,videos_onlyovideo_notes_onlypara notas de vídeo, ylive_notes_onlypara notas de directos. Usa solo los valores permitidos listados para esta API.Valores permitidos:allimage_notes_onlyvideos_only min_likesOpcional- Número mínimo de «me gusta» que debe tener una nota. Usa un valor numérico no negativo. Sirve para filtrar notas por su popularidad, no para limitar el número de resultados devueltos.
sortOpcional- Criterio de orden para notas o comentarios. Valores posibles:
relevance(relevancia),newest(más reciente),popular(popularidad),most_liked(con más «me gusta»),most_commented(con más comentarios),most_collected(con más guardados). Comprueba los valores permitidos para cada acción, ya que no todos son compatibles. No uses los criterios de orden de búsqueda en las acciones de comentarios.Valores permitidos:newestpopularrelevance
¿Qué significan los parámetros de Xiaohongshu user_posts?
Obtiene notas públicas del user_id, con tipo, likes mínimos y orden opcionales. 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. Se usa para obtener los datos de la cuenta o sus notas publicadas. No es el apodo. content_typeOpcional- Filtro por tipo de nota. Usa
alloall_typespara no filtrar,imageoimage_notes_onlypara notas con imagen y texto,video,videos_onlyovideo_notes_onlypara notas de vídeo, ylive_notes_onlypara notas de directos. Usa solo los valores permitidos listados para esta API.Valores permitidos:allimage_notes_onlyvideos_only min_likesOpcional- Número mínimo de «me gusta» que debe tener una nota. Usa un valor numérico no negativo. Sirve para filtrar notas por su popularidad, no para limitar el número de resultados devueltos.
sortOpcional- Criterio de orden para notas o comentarios. Valores posibles:
relevance(relevancia),newest(más reciente),popular(popularidad),most_liked(con más «me gusta»),most_commented(con más comentarios),most_collected(con más guardados). Comprueba los valores permitidos para cada acción, ya que no todos son compatibles. No uses los criterios de orden de búsqueda en las acciones de comentarios.Valores permitidos:newestpopularrelevance
¿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. content_typeOpcional- Filtro por tipo de nota. Usa
alloall_typespara no filtrar,imageoimage_notes_onlypara notas con imagen y texto,video,videos_onlyovideo_notes_onlypara notas de vídeo, ylive_notes_onlypara notas de directos. Usa solo los valores permitidos listados para esta API.Valores permitidos:allimagevideo sortOpcional- Criterio de orden para notas o comentarios. Valores posibles:
relevance(relevancia),newest(más reciente),popular(popularidad),most_liked(con más «me gusta»),most_commented(con más comentarios),most_collected(con más guardados). Comprueba los valores permitidos para cada acción, ya que no todos son compatibles. No uses los criterios de orden de búsqueda en las acciones de comentarios.Valores permitidos:most_collectedmost_commentedmost_likednewestrelevance
¿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. content_typeOpcional- Filtro por tipo de nota. Usa
alloall_typespara no filtrar,imageoimage_notes_onlypara notas con imagen y texto,video,videos_onlyovideo_notes_onlypara notas de vídeo, ylive_notes_onlypara notas de directos. Usa solo los valores permitidos listados para esta API.Valores permitidos:allimagevideo sortOpcional- Criterio de orden para notas o comentarios. Valores posibles:
relevance(relevancia),newest(más reciente),popular(popularidad),most_liked(con más «me gusta»),most_commented(con más comentarios),most_collected(con más guardados). Comprueba los valores permitidos para cada acción, ya que no todos son compatibles. No uses los criterios de orden de búsqueda en las acciones de comentarios.Valores permitidos:most_collectedmost_commentedmost_likednewestrelevance
¿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 objetivos.
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.
¿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. content_typeOpcional- Filtro por tipo de nota. Usa
alloall_typespara no filtrar,imageoimage_notes_onlypara notas con imagen y texto,video,videos_onlyovideo_notes_onlypara notas de vídeo, ylive_notes_onlypara notas de directos. Usa solo los valores permitidos listados para esta API.Valores permitidos:allimagevideo sortOpcional- Criterio de orden para notas o comentarios. Valores posibles:
relevance(relevancia),newest(más reciente),popular(popularidad),most_liked(con más «me gusta»),most_commented(con más comentarios),most_collected(con más guardados). Comprueba los valores permitidos para cada acción, ya que no todos son compatibles. No uses los criterios de orden de búsqueda en las acciones de comentarios.Valores permitidos:most_collectedmost_commentedmost_likednewestrelevance
¿Qué significan los parámetros de Xiaohongshu trending?
Consulta una selección de notas en tendencia sin entrada obligatoria y admite tipo, periodo u orden. La posición observada no explica el algoritmo ni crea historial.
content_typeOpcional- Filtro por tipo de nota. Usa
alloall_typespara no filtrar,imageoimage_notes_onlypara notas con imagen y texto,video,videos_onlyovideo_notes_onlypara notas de vídeo, ylive_notes_onlypara notas de directos. Usa solo los valores permitidos listados para esta API.Valores permitidos:all_typesimage_notes_onlylive_notes_onlyvideo_notes_only date_rangeOpcional- Filtro por fecha de publicación de la nota. Valores:
any_time(sin límite),last_24_hours(últimas 24 horas),last_7_days(últimos 7 días),last_6_months(últimos 6 meses). No filtra por fecha de publicación de los comentarios.Valores permitidos:any_timelast_24_hourslast_6_monthslast_7_days sortOpcional- Criterio de orden para notas o comentarios. Valores posibles:
relevance(relevancia),newest(más reciente),popular(popularidad),most_liked(con más «me gusta»),most_commented(con más comentarios),most_collected(con más guardados). Comprueba los valores permitidos para cada acción, ya que no todos son compatibles. No uses los criterios de orden de búsqueda en las acciones de comentarios.Valores permitidos:most_collectedmost_commentedmost_likednewestrelevance
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 devuelto si la acción es 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>"}}'
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 de origen contengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Xiaohongshu?
La documentación pública de deeplinks 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.