rednote/
home-recommendations

Recopile una página pública de recomendaciones de inicio de Rednote sin una consulta semilla y lea los campos normalizados de publicación, autor, contenido multimedia, interacción y hora de recopilación.

Rednote Home Recommendations API

Sin semilla
Feed de una página
Publicaciones normalizadas
1 crédito por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Rednote Home Recommendations

Una solicitud de recomendaciones de inicio obtiene una página pública del feed de Rednote sin requerir un perfil, la URL de una nota ni una frase de búsqueda. Cada elemento disponible se proyecta en un registro de publicación estándar con identidad de origen, texto, autor, contenido multimedia, interacción visible, hora de publicación y hora de recopilación.

Funcionalidades de la Rednote Home Recommendations API

  • Solicitud de feed de inicio sin semillaEnvíe un cuerpo vacío o la categoría verificada homefeed_recommend para solicitar una página de recomendaciones actual, sin inventar una entrada de usuario ni de consulta.
  • Tamaño de página acotadoSolicite un entero de 1 a 40; si se omite, se usa 20, y la página devuelta puede contener menos elementos públicos.
  • Estructura de publicación independiente del proveedorLea la identidad de la nota, el texto, el autor, el contenido multimedia, las marcas de tiempo y las métricas visibles disponibles mediante el esquema de publicación compartido, en lugar de los nombres de campo del proveedor.
  • Resultados asíncronos duraderosEnvíe una vez, siga el estado de la tarea y pagine los registros almacenados por SocQ después de normalizar la respuesta única del proveedor.

Parámetros de la Rednote Home Recommendations API

ParámetrosObligatorioDescripción
categoryOpcionalCadena opcional y no vacía. Si se omite, la asignación del proveedor inserta homefeed_recommend. Esa es la única categoría definida por el backend que se documenta aquí; las demás cadenas no se presentan como categorías verificadas.
media_typeOpcionalEnumeración opcional: all, image o video. La asignación actual activa el indicador de imagen del proveedor solo para image; all y video se asignan ambos a false, por lo que video no garantiza una respuesta exclusiva de videos.
results_limitOpcionalEntero positivo opcional de 1 a 40. Su valor predeterminado es 20, define el tamaño de página solicitado al proveedor y, cuando se indica de forma explícita, limita las filas almacenadas.

Cómo usar la Rednote Home Recommendations API

Elija solo valores opcionales verificados, envíe la solicitud asíncrona y lea los resultados estándar almacenados.

  1. Comience con los valores predeterminados del backend o defina category, media_type y results_limit de forma explícita.
  2. Envíe el cuerpo JSON por POST a /v1/rednote/home-recommendations y guarde data.task_id de la respuesta del envío.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
  4. Lea data.results.items; siga next_cursor solo cuando has_more se refiera a registros adicionales almacenados en SocQ.
curl -X POST "https://api.socq.ai/v1/rednote/home-recommendations" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"homefeed_recommend","media_type":"all","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor paginates stored results only

Casos de uso de la Rednote Home Recommendations API

  • Instantáneas de la página de recomendaciones: Capture una página pública acotada del feed de inicio con collected_at, para que cada elemento quede ligado a una sola observación.
  • Colas de descubrimiento editorial: Alimente un flujo de revisión humana o de clasificación con el texto, los autores y las referencias multimedia de las publicaciones normalizadas.
  • Auditorías de contenido visible: Compare la mezcla de contenido multimedia disponible y los campos públicos de interacción entre tareas de recomendaciones enviadas por separado.

Consejos de expertos para la Rednote Home Recommendations API

  • Use {} cuando desee todos los valores predeterminados del proveedor; el validador de la solicitud pública no exige ningún campo.
  • Mantenga category en homefeed_recommend, a menos que haya validado por su cuenta otra categoría del proveedor; el entorno de ejecución acepta una cadena no vacía, pero no publica una enumeración de categorías.
  • Trate media_type=video con cautela, porque actualmente se asigna al mismo indicador del proveedor que all; solo image cambia ese indicador.
  • Elija un results_limit entre 1 y 40 y no suponga que el proveedor devolverá exactamente la cantidad solicitada de elementos públicos.
  • No envíe un cursor del proveedor: el ejecutor de origen realiza una sola solicitud y lee items, notes o feeds de esa única respuesta.
  • Use next_cursor solo para continuar por los resultados almacenados en SocQ después del éxito; no obtiene otra página de Rednote.
  • Presupueste un monto fijo de 1.00 créditos de SocQ por tarea; el cargo no varía con el límite seleccionado ni con la cantidad de elementos devueltos.

Además de la Rednote Home Recommendations API, use estas APIs cuando necesite otro tipo de datos públicos de Rednote.

Explorar otras plataformas

Combine los datos de Rednote con datos públicos de otras plataformas sociales compatibles.

Rednote Home Recommendations API — FAQ

Rednote Home Recommendations API recopila una página pública de recomendaciones de inicio de Rednote como registros de publicaciones normalizados.

No. Los tres campos admitidos son opcionales, y un cuerpo JSON vacío usa la categoría homefeed_recommend del proveedor y un tamaño de solicitud de 20 elementos.

El validador público acepta una cadena category no vacía, pero el backend define solo homefeed_recommend como su valor predeterminado estable. Esta página no afirma valores de categoría adicionales a partir de investigaciones externas.

El validador acepta video, pero la transformación actual del proveedor asigna video y all al mismo indicador false. Solo image cambia ese indicador, por lo que no se garantiza una respuesta exclusiva de videos.

No. La llamada al proveedor es de una sola página; next_cursor pertenece al lector compartido de resultados de tareas de SocQ y solo pagina los registros ya almacenados de la tarea completada.

No. No acepta estado de inicio de sesión, identidad de usuario, acciones de cuenta, comandos de publicación ni controles de moderación.

Cada tarea usa un monto fijo de 1.00 créditos de SocQ, independientemente de results_limit y de la cantidad de registros devueltos.