Os resultados do Gemini passam a trazer produtos e lugares

Os resultados de GEMINI agora incluem os cards de produto e os lugares que o Gemini mostra na resposta.

O que muda

• shoppingCards: os cards de produto que o Gemini mostra, com título, posição, preço, loja, avaliação, resenhas, miniatura e productLink para a página do produto no Google.
• inlineProducts: os produtos com link dentro do texto da resposta, com título, posição e productLink.
• map: os lugares que o Gemini recomenda em perguntas sobre lugares, com endereço, coordenadas, telefone, site, link do Google Maps, avaliação e categoria.

Como funciona

Quando você pergunta ao Gemini o que comprar ou aonde ir, boa parte da resposta fica fora do texto: uma fileira de cards de produto com preços ou uma lista de lugares em um mapa. Agora isso chega como campos estruturados ao lado de text, na ordem em que o Gemini mostra, então position diz qual produto ou lugar aparece primeiro.

price chega como {value, currency, raw}, o que facilita comparar preços entre lojas. Cada lugar traz placeId, uma location com address, latitude e longitude, e reviews com a avaliação, o número de resenhas e a origem. Os títulos dos cards também continuam em text, então as contagens de menções baseadas no texto mantêm os mesmos números.

Onde ajuda

• Acompanhe se o seu produto aparece em um card de produto do Gemini, em que posição e por qual preço.
• Veja para quais lojas o Gemini envia os compradores da sua categoria.
• Confira quais clínicas, restaurantes ou lojas o Gemini recomenda em um bairro, com as avaliações.

Envie a requisição

Envie a requisição com a sua chave de API no cabeçalho Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": {
      "prompt": "Best ramen near me",
      "country": "US",
      "location": { "latitude": 40.72927, "longitude": -73.98736 }
    }
  }'

Campos da requisição

taskTypestringObrigatório

O motor que executa a tarefa, como CHATGPT ou GOOGLE.

payload.promptstringObrigatório

A pergunta, escrita como o usuário digita no chat. Até 100.000 caracteres.

payload.countrystring

Código de país de duas letras do mercado de onde a pergunta parte, como US, KR ou JP. Padrão US.

payload.locationobject

Um ponto dentro de country, com latitude (-90 a 90) e longitude (-180 a 180) em graus decimais, por exemplo {"latitude": 37.4979, "longitude": 127.0276}. O motor responde como a um usuário que está ali. Para CHATGPT, GEMINI, GOOGLE, AIMODE e GOOGLE_SERP.

payload.include.markdownboolean

Com true, chega também markdown: a resposta com títulos, listas, tabelas e links.

Resposta

Uma tarefa concluída chega assim, resumida para facilitar a leitura.

{
  "success": true,
  "task": {
    "id": "685aad4a-3191-4215-9d2a-93ada8376185",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:51:49.105Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "text": "**[IPPUDO NY](https://maps.google.com/?cid=13390953617500975094)** · ★ 4.4 (5,519) · Restaurant · 65 4th Ave, New York, NY 10003\n…",
    "map": [
      {
        "position": 4,
        "name": "IPPUDO NY",
        "category": "Restaurant",
        "location": {
          "address": "65 4th Ave, New York, NY 10003",
          "latitude": 40.730948,
          "longitude": -73.990287
        },
        "reviews": [
          { "count": 5519, "rating": 4.4, "providerName": "Google" }
        ],
        "phoneNumber": "+1 212-388-0088",
        "url": "https://www.ippudous.com/east-village",
        "mapsUrl": "https://maps.google.com/?cid=13390953617500975094"
      }
    ],
    "location": { "latitude": 40.72927, "longitude": -73.98736 }
  }
}

response.maparray

Lugares recomendados na resposta: nome, endereço, coordenadas, avaliação, categoria e link do mapa.

response.shoppingCardsarray

Cartões de produto exibidos com a resposta: nome, preço, loja, avaliação e link.

response.inlineProductsarray

Nomes de produto com link dentro das frases da resposta, com position e productLink.

response.locationobject

O ponto usado na resposta, como você o enviou: latitude e longitude.

Receba o resultado

A requisição devolve a tarefa na hora, com status QUEUED. Consulte GET /v1/async/task/{id} até status virar COMPLETED ou FAILED, ou adicione webhook.url e a tarefa concluída chega ao seu servidor com os mesmos task, credits e response. Os resultados ficam disponíveis por 24 horas após o fim da tarefa.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Preço

O preço continua em 1 crédito por tarefa concluída, com produtos e lugares incluídos.