https://api.nexscope.ai/ai-search/googleSearchEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/ai-search/googleSearch |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyword | string | obligatorio | Google buscar palabras clave como `q=` Para iniciar la búsqueda en Google AI Mode, sólo se admite una ronda de diálogo; si necesita hacer preguntas, el agente debe resumir la información clave de la ronda anterior de información general sobre IA y empalmar nuevas preguntas, y luego iniciar una solicitud como una nueva `keyword`. |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.
Campos de respuesta
Referencia de campos de respuesta (9 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
stdout | string | opcional | Texto de AI, en formato Markdown; salida de los puntos de AI y enlaces de referencia para cada pregunta párrafo por párrafo en orden de preguntas. |
sourceUrl | string | opcional | Atrapen al objetivo URL y finalmente enviarlo a la dirección de la página de búsqueda de Google. |
resultsNum | integer | opcional | El número de bloques de AI; mayor que 0 significa que la página representa AI Vista general, y 0 significa que la palabra clave no desencadena AI Vista general. |
code | string | opcional | Código de estado de negocio, éxito es `"200"`, correspondiente a la versión numérica de `errcode`. |
errcode | integer | opcional | Código de la situación empresarial; `200` indica éxito, otros valores indican errores de negocio. |
costTime | integer | opcional | La interfaz toma tiempo en milisegundos. |
costToken | integer | opcional | Esta llamada consume el número de Tokens; sólo se facturará si el upstream devuelve correctamente. |
taskId | string | opcional | La identificación de esta tarea de arrastre devuelto por la corriente ascendente. |
type | string | opcional | El estilo de renderizado, fijado a `stdoutWorkbenches`, se representa en formato Markdown con el `stdout` campo. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.