API do Google AI Mode: respostas, Markdown e fontes - querying.ai

AIMODE pergunta ao Google AI Mode e retorna a resposta, sempre com Markdown, e as fontes por trás dela.


taskType	`AIMODE`
Aliases	`GOOGLE_AIMODE`
Lê	`query` (recorre a `prompt`)
Créditos	1,25
País	Opcional, padrão `US`. `CN` pergunta diretamente ao mercado chinês do Google, sem a substituição pelos EUA que o AI Overviews faz.
Localização	Aceita `payload.location`. Veja Regiões e localização.

Requisição

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" } }'

Resposta

Ao contrário do Google AI Overviews, o AI Mode retorna uma resposta simples, não um envelope de página de resultados.

Campo	Tipo	Descrição
`text`	string	A resposta. Sempre presente.
`markdown`	string	A resposta em Markdown. Retornado sem nenhuma flag.
`sources`	array	`position`, `url`, `label`, `description`.
`shoppingCards`, `inlineProducts`	array	Produtos na resposta, com os mesmos campos do AI Overviews.
`citationPills`	array	As fontes por trás de cada chip de citação, com os mesmos campos do AI Overviews.
`videos`	array	Vídeos que a resposta mostra.
`rawContent`	string	O HTML renderizado da página. Só com `include.rawResponse`.

Os campos de produto, chip e vídeo só aparecem quando a resposta os mostra. Por exemplo:

{
  "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" }]
}

Quando o Google carrega a página mas não retorna resposta em duas sessões novas, a tarefa falha com ENGINE_NO_RESULT em vez de esperar.

Flags include

Flag	Efeito
`rawResponse`	Adiciona `rawContent`.
`html`	Adiciona `html`, a página que o Google mostrou. Veja Páginas HTML.
`analysis`	Adiciona `analysis`, 1 crédito. Veja Análise da resposta.
`citationAnalysis`	Executa uma Citation Analysis sobre a resposta.

markdown não precisa de flag. searchQueries, ads e shopping não têm efeito. Veja Markdown e respostas brutas.

Relacionados