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ámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Texto 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_by | Opcional | Orden opcional de los resultados: general, latest o most_liked. El Playground comienza con general. |
media_type | Opcional | Filtro opcional del formato de la nota: all, image o video. El Playground comienza con all. |
published_within | Opcional | Filtro 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.
- Prepare una consulta no vacía y elija solo valores compatibles de sort_by, media_type y published_within.
- Envíe el contenido por POST a /v1/rednote/search-notes y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
- 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 trueCasos 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.
APIs relacionadas
Además de la Rednote Search Notes API, use estas APIs cuando necesite otro tipo de datos públicos de Rednote.