Rednote Search Users
La búsqueda pública de cuentas de Rednote puede mostrar la identidad, la biografía, el estado del perfil y los conteos visibles de audiencia o de contenido de las personas que coinciden con una consulta de texto. Los registros de cuenta normalizados conservan los campos de la fuente que están disponibles y agregan collected_at para un descubrimiento y una comparación rastreables.
Funcionalidades de la Rednote Search Users API
- Descubrimiento de cuentas con una sola consultaEnvíe una consulta no vacía que se asigna a la palabra clave del proveedor en su primera página fija, sin controles de página de la fuente ni filtros adicionales.
- Identidad pública normalizadaRecibe una estructura de cuenta estable con el ID, el nombre de usuario, el nombre visible, la biografía, la URL pública, las imágenes del perfil, el sitio web y los campos de verificación y privacidad que estén disponibles.
- Instantánea visible de la cuentaMantiene los conteos de seguidores, seguidos y publicaciones disponibles junto con collected_at, de modo que cada valor devuelto quede ligado a su momento de observación.
Parámetros de la Rednote Search Users API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Cadena obligatoria y no vacía asignada a la palabra clave del proveedor. Este endpoint no tiene campos de enumeración, results_limit, cursor del proveedor, orden ni filtro de contenido multimedia. |
Cómo usar la Rednote Search Users API
Envíe un término de búsqueda de cuentas, siga la tarea asíncrona y lea sus registros de cuenta normalizados almacenados.
- Elija un término no vacío que represente la cuenta pública, el nombre del creador de contenido, la marca o el tema que desea descubrir.
- Envíe query a /v1/rednote/search-users y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
- Lea data.results.items; si la respuesta de resultados almacenados devuelve has_more, continúe con su next_cursor.
curl -X POST "https://api.socq.ai/v1/rednote/search-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"photography"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor paginates stored results onlyCasos de uso de la Rednote Search Users API
- Armar una lista corta de creadores de contenido: Descubra cuentas públicas a partir de un nombre o un término temático y luego revise los campos de identidad y biografía disponibles antes de seleccionar candidatos.
- Enriquecer un directorio de cuentas: Agregue ID, nombres de usuario, nombres visibles, texto del perfil, imágenes, URL, sitios web e indicadores de cuenta normalizados a una lista de descubrimiento.
- Comparar señales públicas de cuentas: Use los conteos disponibles de seguidores, seguidos y publicaciones como instantáneas con collected_at, sin tratarlos como analíticas privadas ni como totales en vivo.
Consejos de expertos para la Rednote Search Users API
- Envíe solo query; este endpoint rechaza results_limit, cursor, page, sort, filter, media_type y campos adicionales.
- Trate la llamada al proveedor como una primera página fija. El next_cursor del lector compartido de tareas pagina las filas de SocQ ya almacenadas, no páginas adicionales de la fuente de Rednote.
- Admita que los ID, los nombres de usuario, los nombres, la biografía, las imágenes, los sitios web, los indicadores de cuenta y cada métrica sean nulos cuando la respuesta pública los omita.
- Almacene collected_at junto con los conteos visibles y presupueste un monto fijo de 1.00 créditos de SocQ por cada tarea exitosa, sin importar la cantidad de cuentas devueltas.
APIs relacionadas
Además de la Rednote Search Users API, use estas APIs cuando necesite otro tipo de datos públicos de Rednote.