Rednote Public Data APIs
Obtenga perfiles y notas públicos, busque notas o usuarios, recopile comentarios y respuestas anidadas, y capture una página de recomendaciones de inicio.
API de Rednote disponibles
Elija entre ocho API para flujos de perfiles, notas, comentarios, respuestas, búsqueda y recomendaciones.

rednote/comment-replies
Comentarios1 crédito por solicitud

rednote/home-recommendations
Publicaciones1 crédito por solicitud

rednote/note-comments
Comentarios1 crédito por solicitud

rednote/note-detail
Publicaciones1 crédito por solicitud

rednote/search-notes
Búsqueda1 crédito por solicitud

rednote/search-users
Búsqueda1 crédito por solicitud

rednote/user-notes
Publicaciones1 crédito por solicitud

rednote/user-profile
Perfiles1 crédito por solicitud
¿Qué datos de Rednote se pueden obtener?
El catálogo de Rednote devuelve registros normalizados de cuentas, publicaciones y comentarios a partir de datos de origen públicos.
Perfiles y notas de usuarios
Resuelva un perfil público o recopile una página de origen de notas con una URL de cuenta compatible o un user_id.
Detalles de notas y descubrimiento
Obtenga una URL de nota con token, busque notas con los filtros compatibles o recopile una página de recomendaciones de inicio.
Búsqueda de usuarios
Busque en la primera página de origen fija de cuentas públicas con una sola consulta no vacía.
Comentarios y respuestas
Recopile una página de comentarios públicos de una nota o una página de respuestas para un ID de comentario conocido.
Especificaciones de las API de Rednote de un vistazo
Cada endpoint tiene una solicitud de origen acotada y rechaza los parámetros no declarados.
| Grupo de API | Entrada inicial | Límite de origen |
|---|---|---|
| Perfil y notas de usuario | url o user_id | Un perfil o una página de origen; sin results_limit |
| Detalle de nota | URL compatible con ruta de nota y xsec_token | Como máximo un registro de nota |
| Búsqueda | Consulta no vacía y enums opcionales compatibles | Primera página de origen fija; sin results_limit |
| Comentarios y respuestas | URL de nota compatible; las respuestas también requieren comment_id | Una página de respuesta de origen |
| Recomendaciones de inicio | Todos los campos son opcionales | Una página con results_limit de 1–40, 20 de forma predeterminada |
Cómo funcionan las API de Rednote
Los ocho endpoints usan el mismo flujo asíncrono de envío, consulta y resultado almacenado.
1. Elegir el endpoint
Seleccione el endpoint de perfil, nota, búsqueda, comentarios, respuestas o recomendaciones para su tarea de datos públicos.
2. Enviar una entrada válida
Envíe por POST solo los campos declarados y guarde el task_id devuelto.
3. Leer los resultados normalizados
Consulte la tarea hasta que llegue a un estado final, luego lea data.results.items y use next_cursor solo para la paginación de resultados almacenados.
Autentíquese con una clave de API de SocQ y envíe una consulta con los filtros opcionales compatibles. Cada tarea de Rednote exitosa cuesta 1 crédito fijo.
curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"travel guide","sort_by":"general","media_type":"all"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successCasos de uso frecuentes de las API de Rednote
Investigación de creadores y contenido
Combine la identidad pública de una cuenta con una página acotada de notas de su autoría.
Descubrimiento de temas
Compare instantáneas de búsqueda de notas, búsqueda de usuarios y recomendaciones de inicio con sus marcas de tiempo de recopilación.
Revisión de conversaciones
Inspeccione los comentarios de una nota pública y las respuestas anidadas de un comentario seleccionado como registros normalizados.
Límites y política de datos públicos
Estos endpoints leen datos públicos mediante solicitudes de origen acotadas y no ofrecen acciones de cuenta ni acceso privado.
- Los hosts de URL compatibles son xiaohongshu.com, xhslink.com y sus subdominios; Note Detail requiere además una ruta /explore/{id} o /discovery/item/{id} y un xsec_token no vacío.
- user_id y comment_id aceptan de 1 a 256 letras ASCII, números, dos puntos, guiones bajos o guiones.
- Search Notes acepta sort_by, media_type y published_within solo con los valores de enum indicados; Search Users acepta solo query.
- Solo Home Recommendations acepta results_limit, con un rango de 1–40 y un valor predeterminado de 20.
- Cada tarea de Rednote exitosa cuesta 1 crédito fijo.
Preguntas frecuentes sobre las API de Rednote
¿Qué son las API de Rednote?
Las API de Rednote obtienen perfiles, notas, comentarios, respuestas anidadas, resultados de búsqueda y recomendaciones de inicio públicos como registros normalizados.
¿Qué endpoint acepta results_limit?
Solo Home Recommendations acepta results_limit, como un entero de 1 a 40. Los demás endpoints de Rednote lo rechazan.
¿Note Detail acepta cualquier URL de Rednote?
No. Requiere un host aceptado, una ruta /explore/{id} o /discovery/item/{id} y un valor xsec_token no vacío en la cadena de consulta.
¿Cuánto cuestan las solicitudes de Rednote?
Cada tarea exitosa cuesta 1 crédito de SocQ fijo.
Combine datos de varias plataformas para obtener información de negocio más completa
Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.
Kwai API
Obtenga perfiles públicos de Kwai, una página de publicaciones de una cuenta o una publicación conocida, con identidad, contenido, contenido multimedia, marcas de tiempo e interacción visible normalizados.
Truth Social API
Obtenga los datos de una cuenta pública, recopile una página de origen de publicaciones de una cuenta o convierta la URL de una publicación conocida en registros normalizados.
Google Ad Library API
Descubra anunciantes públicos, obtenga las creatividades de una empresa o consulte por URL una creatividad conocida del Transparency Center para investigación y revisión.
Google Maps API
Descubra lugares públicos, consulte detalles normalizados de URL conocidas de Maps y obtenga reseñas públicas con contexto del lugar y del autor vinculado a la fuente.
Amazon API
Busque productos públicos de Amazon y obtenga registros normalizados de detalles de productos, Best Sellers, reseñas, perfiles de vendedores y tiendas de creadores de los marketplaces compatibles.
Apple App Store API
Obtenga detalles públicos de apps de Apple App Store, clasificaciones por categoría y reseñas a partir de URL conocidas de la tienda, como registros normalizados de apps y reseñas.