Volver a las API
Datos públicos de Rednote

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.

¿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 APIEntrada inicialLímite de origen
Perfil y notas de usuariourl o user_idUn perfil o una página de origen; sin results_limit
Detalle de notaURL compatible con ruta de nota y xsec_tokenComo máximo un registro de nota
BúsquedaConsulta no vacía y enums opcionales compatiblesPrimera página de origen fija; sin results_limit
Comentarios y respuestasURL de nota compatible; las respuestas también requieren comment_idUna página de respuesta de origen
Recomendaciones de inicioTodos los campos son opcionalesUna 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. 1. Elegir el endpoint

    Seleccione el endpoint de perfil, nota, búsqueda, comentarios, respuestas o recomendaciones para su tarea de datos públicos.

  2. 2. Enviar una entrada válida

    Envíe por POST solo los campos declarados y guarde el task_id devuelto.

  3. 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.

Buscar notas públicas de Rednote

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 success

Casos 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.

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.