Produkte und Orte aus Gemini-Antworten

GEMINI-Ergebnisse enthalten jetzt die Produktkarten und Orte, die Gemini in seiner Antwort zeigt.

Was sich ändert

• shoppingCards: die Produktkarten, die Gemini zeigt, mit Titel, Position, Preis, Shop, Bewertung, Rezensionen, Vorschaubild und productLink zur Google-Produktseite.
• inlineProducts: die im Antworttext verlinkten Produkte mit Titel, Position und productLink.
• map: die Orte, die Gemini bei Ortsfragen empfiehlt, mit Adresse, Koordinaten, Telefonnummer, Website, Google-Maps-Link, Bewertung und Kategorie.

So funktioniert es

Wenn Sie Gemini fragen, was Sie kaufen oder wohin Sie gehen sollen, steht ein großer Teil der Antwort außerhalb des Textes: eine Reihe von Produktkarten mit Preisen oder eine Liste von Orten auf einer Karte. Diese Elemente kommen jetzt als strukturierte Felder neben text, in der Reihenfolge, in der Gemini sie zeigt. position verrät Ihnen also, welches Produkt oder welcher Ort zuerst kommt.

price kommt als {value, currency, raw}, damit Sie Preise zwischen Shops direkt vergleichen. Jeder Ort enthält placeId, eine location mit address, latitude und longitude sowie reviews mit Bewertung, Anzahl der Rezensionen und Anbieter. Die Titel der Karten bleiben auch in text, sodass Zählungen von Erwähnungen auf Basis des Textes dieselben Zahlen liefern.

Einsatzbereiche

• Verfolgen Sie, ob Ihr Produkt als Gemini-Produktkarte erscheint, an welcher Position und zu welchem Preis.
• Sehen Sie, zu welchen Shops Gemini Käufer in Ihrer Kategorie schickt.
• Prüfen Sie, welche Praxen, Restaurants oder Geschäfte Gemini in einem Viertel empfiehlt, samt Bewertungen.

Anfrage senden

Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header 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 }
    }
  }'

Felder der Anfrage

taskTypestringPflicht

Die Engine, die die Aufgabe ausführt, etwa CHATGPT oder GOOGLE.

payload.promptstringPflicht

Die Frage, so formuliert, wie ein Nutzer sie in den Chat tippt. Bis zu 100.000 Zeichen.

payload.countrystring

Zweistelliger Ländercode des Markts, aus dem gefragt wird, etwa US, KR oder JP. Standard US.

payload.locationobject

Ein Punkt innerhalb von country, mit latitude (-90 bis 90) und longitude (-180 bis 180) in Dezimalgrad, etwa {"latitude": 37.4979, "longitude": 127.0276}. Die Engine antwortet wie einem Nutzer vor Ort. Für CHATGPT, GEMINI, GOOGLE, AIMODE und GOOGLE_SERP.

payload.include.markdownboolean

Mit true kommt markdown hinzu: die Antwort mit Überschriften, Listen, Tabellen und Links.

Antwort

So sieht eine fertige Aufgabe aus, für die Lesbarkeit gekürzt.

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

In der Antwort empfohlene Orte: Name, Adresse, Koordinaten, Bewertung, Kategorie und Kartenlink.

response.shoppingCardsarray

Produktkarten zur Antwort: Titel, Preis, Shop, Bewertung und Produktlink.

response.inlineProductsarray

In den Sätzen der Antwort verlinkte Produktnamen, mit position und productLink.

response.locationobject

Der Punkt, für den die Antwort gilt, so wie Sie ihn gesendet haben: latitude und longitude.

Ergebnis abholen

Die Anfrage liefert sofort die Aufgabe mit status QUEUED. Fragen Sie GET /v1/async/task/{id} ab, bis status COMPLETED oder FAILED ist, oder geben Sie webhook.url an, dann kommt die fertige Aufgabe mit denselben task, credits und response auf Ihrem Server an. Ergebnisse bleiben 24 Stunden nach Abschluss abrufbar.

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

Preis

Der Preis bleibt bei 1 Credit pro abgeschlossener Aufgabe, Produkte und Orte inklusive.