rednote/
search-notes

Busque notas públicas de Rednote por consulta de texto con filtros opcionales de orden, contenido multimedia y período, con contenido, autores, contenido multimedia, marcas de tiempo e interacción visible, todo normalizado.

Rednote Search Notes API

Búsqueda de notas por palabra clave
Filtros de orden y contenido multimedia
Instantánea pública de una página
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 Search Notes

Los resultados de Rednote Search Notes son publicaciones públicas que coinciden con una palabra clave, con la identidad de la nota, el texto, el contexto del autor, el contenido multimedia, la hora de publicación y la interacción visible. Estos registros sirven para investigar temas, comparar formatos, revisar fuentes y analizar resultados de búsqueda en un momento dado.

Funcionalidades de la Rednote Search Notes API

  • Búsqueda por palabra clave con tres dimensiones de filtroAcepta una consulta de texto junto con las opciones compatibles de orden, tipo de contenido multimedia y ventana de publicación, para definir una búsqueda pública de notas enfocada.
  • Identidad y contenido de notas normalizadosDevuelve los ID de las notas, las URL públicas, el texto, el tipo de recurso, la hora de publicación y la hora de recopilación con la estructura compartida PostItem.
  • Contexto del autor, del contenido multimedia y de la interacción visibleConserva los campos públicos disponibles del autor, las referencias de imágenes o videos, los hashtags, las menciones y los conteos visibles de Me gusta, comentarios, veces compartido y vistas.
  • Página de búsqueda de la fuente acotadaEjecuta una vez por tarea la página 1 de la búsqueda seleccionada, lo que produce una instantánea definida y no pretende ser un rastreo exhaustivo de varias páginas de la fuente.

Parámetros de la Rednote Search Notes API

ParámetrosObligatorioDescripción
queryObligatorioTexto obligatorio y no vacío que se usa para buscar notas públicas de Rednote; el Playground lo deja en blanco hasta que usted indique su propio término.
sort_byOpcionalOrden opcional de los resultados: general, latest o most_liked. El Playground comienza con general.
media_typeOpcionalFiltro opcional del formato de la nota: all, image o video. El Playground comienza con all.
published_withinOpcionalFiltro opcional de la ventana de publicación: all, day, week o six_months. El Playground comienza con all.

Cómo usar la Rednote Search Notes API

Envíe una consulta de búsqueda de Rednote y filtros opcionales, siga la tarea asíncrona y luego lea los registros de notas almacenados con la paginación por cursor de SocQ.

  1. Prepare una consulta no vacía y elija solo valores compatibles de sort_by, media_type y published_within.
  2. Envíe el contenido por POST a /v1/rednote/search-notes y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. Lea data.results.items y siga next_cursor mientras has_more sea true; esto pagina los resultados almacenados, no páginas adicionales de búsqueda de Rednote.
curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"$REDNOTE_SEARCH_QUERY\",\"sort_by\":\"general\",\"media_type\":\"all\",\"published_within\":\"all\"}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Rednote Search Notes API

  • Catalogación de resultados por palabra clave: Use los ID de las notas, las URL públicas, el texto, las referencias de autor y collected_at para armar una instantánea rastreable de una consulta definida.
  • Comparación de resultados de imágenes y videos: Ejecute selecciones separadas de media_type y compare las referencias multimedia devueltas, el texto de las notas y la interacción visible entre las instantáneas resultantes.
  • Revisión de temas centrada en lo reciente: Combine el orden latest o una ventana de publicación con published_at y collected_at para revisar las notas recién aparecidas sobre un tema.
  • Análisis del contexto de los autores: Asocie el texto y el contenido multimedia de las notas coincidentes con los campos de identidad del autor disponibles, para examinar qué cuentas públicas aparecen en la instantánea de una consulta.

Consejos de expertos para la Rednote Search Notes API

  • Recorte la consulta y confirme que no esté vacía antes del envío, para que la validación del campo obligatorio no rechace la tarea.
  • Use solo los valores de enumeración documentados; elija general, all y all cuando desee la búsqueda más amplia configurada de forma explícita.
  • Trate cada tarea como una página de búsqueda de la fuente y ejecute tareas separadas para distintas combinaciones de filtros, en lugar de suponer que la instantánea cubre páginas posteriores de la fuente.
  • Siga next_cursor hasta que has_more sea false cuando la instantánea almacenada abarque varias páginas de resultados de SocQ; este cursor nunca solicita otra página de la fuente de Rednote.
  • Use el ID y la URL de la nota al conciliar ejecuciones de consultas distintas, porque el orden y las métricas visibles pueden diferir entre momentos de recopilación.
  • Maneje como nulos el texto, los campos del autor, el contenido multimedia, la hora de publicación, los hashtags, las menciones y cada métrica, y aplique escape al texto público antes de mostrarlo.

Explorar otras plataformas

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

Rednote Search Notes API — FAQ

Rednote Search Notes API encuentra notas públicas de Rednote a partir de una consulta de texto con filtros opcionales de orden, tipo de contenido multimedia y ventana de publicación, y devuelve la identidad normalizada de la nota, el texto, el contexto del autor, el contenido multimedia, las marcas de tiempo y los campos de interacción visibles.

query es obligatorio. sort_by acepta general, latest o most_liked; media_type acepta all, image o video; published_within acepta all, day, week o six_months.

El ejemplo predeterminado usa query 旅行攻略 con sort_by general y media_type all, mientras que published_within se omite. El endpoint no acepta results_limit, un número de página ni un cursor de la fuente.

Cada PostItem puede contener el ID de la nota, la URL, el texto, los detalles del autor, el contenido multimedia, las marcas de tiempo de publicación y de recopilación, los hashtags, las menciones y los conteos visibles de Me gusta, comentarios, veces compartido y vistas. Los valores opcionales de la fuente permanecen nulos cuando no están disponibles.

No. Cada tarea solicita una vez la página 1 de la fuente; next_cursor solo lee la siguiente página de resultados ya almacenados por SocQ, con límites de resultados de la tarea de 1 a 500 y un valor predeterminado de 50.

Cada tarea usa un monto fijo de 1 crédito de SocQ. La cantidad de notas almacenadas o devueltas no cambia ese cargo fijo por tarea.