API de Google AI Mode: respuestas, Markdown y fuentes - querying.ai

AIMODE pregunta a Google AI Mode y devuelve su respuesta, siempre con Markdown, y las fuentes en las que se apoya.


taskType	`AIMODE`
Alias	`GOOGLE_AIMODE`
Lee	`query` (recurre a `prompt`)
Créditos	1,25
País	Opcional, por defecto `US`. `CN` pregunta directamente al mercado chino de Google, sin la sustitución por EE. UU. que hace AI Overviews.
Ubicación	Acepta `payload.location`. Consulta Regiones y ubicación.

Solicitud

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "AIMODE", "payload": { "query": "best CRM for a small team", "country": "US" } }'

Respuesta

A diferencia de Google AI Overviews, AI Mode devuelve una respuesta suelta, no un sobre de página de resultados.

Campo	Tipo	Descripción
`text`	string	La respuesta. Siempre presente.
`markdown`	string	La respuesta en Markdown. Se devuelve sin ningún flag.
`sources`	array	`position`, `url`, `label`, `description`.
`shoppingCards`, `inlineProducts`	array	Productos de la respuesta, con los mismos campos que en AI Overviews.
`citationPills`	array	Las fuentes detrás de cada chip de cita, con los mismos campos que en AI Overviews.
`videos`	array	Vídeos que muestra la respuesta.
`rawContent`	string	El HTML renderizado de la página. Solo con `include.rawResponse`.

Los campos de productos, chips y vídeos solo aparecen cuando la respuesta los muestra. Por ejemplo:

{
  "text": "For a small team, start with HubSpot CRM or Pipedrive ...",
  "markdown": "For a small team, start with **HubSpot CRM** or **Pipedrive** ...",
  "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide", "label": "CRM guide for small teams" }]
}

Cuando Google carga la página pero no devuelve respuesta en dos sesiones nuevas, la tarea falla con ENGINE_NO_RESULT en lugar de seguir esperando.

Flags include

Flag	Efecto
`rawResponse`	Añade `rawContent`.
`html`	Añade `html`, la página que mostró Google. Consulta Páginas HTML.
`analysis`	Añade `analysis`, 1 crédito. Consulta Análisis de la respuesta.
`citationAnalysis`	Ejecuta un Citation Analysis sobre la respuesta.

markdown no necesita flag. searchQueries, ads y shopping no tienen efecto. Consulta Respuestas en Markdown y en bruto.

Relacionado