Les résultats Gemini s’enrichissent des produits et des lieux

Les résultats GEMINI incluent désormais les fiches produit et les lieux que Gemini affiche dans sa réponse.

Ce qui change

• shoppingCards : les fiches produits affichées par Gemini, avec titre, position, prix, boutique, note, avis, miniature et productLink vers la page produit Google.
• inlineProducts : les produits liés dans le texte de la réponse, avec titre, position et productLink.
• map : les lieux que recommande Gemini pour les questions de lieux, avec adresse, coordonnées, téléphone, site web, lien Google Maps, note et catégorie.

Fonctionnement

Quand vous demandez à Gemini quoi acheter ou où aller, une grande partie de la réponse se trouve hors du texte : une rangée de fiches produits avec leurs prix, ou une liste de lieux sur une carte. Ces éléments arrivent désormais en champs structurés à côté de text, dans l’ordre où Gemini les affiche : position vous indique quel produit ou quel lieu vient en premier.

price arrive sous la forme {value, currency, raw}, ce qui facilite la comparaison des prix entre boutiques. Chaque lieu comporte placeId, une location avec address, latitude et longitude, et reviews avec la note, le nombre d’avis et leur source. Les titres des fiches restent aussi dans text : les comptages de mentions fondés sur le texte gardent les mêmes chiffres.

Cas d’usage

• Suivez si votre produit apparaît dans une fiche produit de Gemini, à quelle position et à quel prix.
• Voyez vers quelles boutiques Gemini envoie les acheteurs de votre catégorie.
• Vérifiez quelles cliniques, quels restaurants ou quelles boutiques Gemini recommande dans un quartier, avec leurs notes.

Envoyer la requête

Envoyez la requête avec votre clé API dans l’en-tête 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 }
    }
  }'

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.promptstringObligatoire

La question, rédigée comme un utilisateur la tape dans le chat. Jusqu’à 100 000 caractères.

payload.countrystring

Code pays à deux lettres du marché d’où part la question, par exemple US, KR ou JP. Par défaut US.

payload.locationobject

Un point situé dans country, avec latitude (-90 à 90) et longitude (-180 à 180) en degrés décimaux, par exemple {"latitude": 37.4979, "longitude": 127.0276}. Le moteur répond comme à un utilisateur qui s’y trouve. Pour CHATGPT, GEMINI, GOOGLE, AIMODE et GOOGLE_SERP.

payload.include.markdownboolean

Avec true, la réponse arrive aussi en markdown, avec ses titres, listes, tableaux et liens.

Réponse

Voici une tâche terminée, raccourcie pour la lecture.

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

Lieux recommandés dans la réponse : nom, adresse, coordonnées, note, catégorie et lien de carte.

response.shoppingCardsarray

Fiches produits affichées avec la réponse : nom, prix, boutique, note et lien.

response.inlineProductsarray

Noms de produits liés dans les phrases de la réponse, avec position et productLink.

response.locationobject

Le point retenu pour la réponse, tel que vous l’avez envoyé : latitude et longitude.

Recevoir le résultat

La requête renvoie aussitôt la tâche avec status QUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.

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

Tarif

Le tarif reste de 1 crédit par tâche terminée, produits et lieux compris.