Skip to content
Last updated

Google Shopping

Google Shopping product and offer data. Search by keyword, by Google product ID, or by a structured product record for higher-precision matching. See the Google Shopping use case →

Supported countries

country accepts: us de uk (gb) au at br ca cz dk fr in ie it jp mx no pl nz nl ru sg za es se fi ch tr ar cl co be gr hu pt ro sk hk id il my ph sa kr tw th ua vn ae

uk and gb are two codes for the same UK marketplace — not a separate locale.

Keys

KeyValuesDescription
termFree textKeyword search — returns a list of product cards.
idGoogle Shopping product IDDirect product lookup with offers.
productStructured product recordGTIN plus additional product data — the highest-precision lookup (see format below).

product — send a GTIN plus additional data

Google Shopping has no direct GTIN lookup, so a bare GTIN can be ambiguous. With key: product you send the GTIN together with everything else you know about the product — title, brand, your price, a deeplink — and kwery uses all of it to select the right Google Shopping product. This is the recommended key when your catalog has more than just an EAN.

The value is a ||-separated record; empty fields are allowed, position is fixed:

title||brand||gtin||price||deeplink||size

Example:

STABILO point 88||STABILO||4006381333962||6.49||https://www.example.de/stabilo-point-88||

The title and the deeplink host carry the most matching signal — include them whenever you have them.

Topics

TopicDescription
search (default)Product lookup with seller offers.

Product content fields

List responses carry a top-level currency beside the price_min / price_avg / price_max aggregates.

FieldDescription
product_idGoogle Shopping product ID.
identityProduct identity key.
nameProduct title.
brand_nameBrand, where available.
descriptionProduct description.
urlProduct URL.
rating / rating_countAggregate reviews.
price_min / price_avg / price_maxOffer price aggregates.
offers_countNumber of offers gathered.
total_offers_countTotal seller count Google reports for the product (may exceed offers_count).
offersSeller offers (seller name, price, currency, shipping, condition).

For key: term, the result is a list of product cards, each with the product id you can use for a follow-up lookup.

When total_offers_count is greater than offers_count, the snapshot is partial — more sellers exist than were gathered. On stream deliveries with include_meta: true, this is also surfaced as meta.partial.

Example request

curl -s https://api.kwery.co/job \
  -H "Authorization: Bearer $KWERY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source":"google","country":"de","key":"product","values":["STABILO point 88||STABILO||4006381333962||||"]}'

Example response

Results are fetched with GET /job/{id}/download once the job is finished. This is a real response, captured live on 2026-09-14 — the exact payload a self-serve account receives for the request above. The payload is complete and unedited. offers_count: 5 against total_offers_count: 44 shows a partial snapshot — Google reports 44 sellers, 5 were gathered on this page (see the note above the field table). The product record resolved the exact catalog product (identity), which is why trust.score is 0.98.

{
  "job_id": "6aa7b6bdda6a238d129dc3e7",
  "status": "finished",
  "results": [
    {
      "query": {
        "source": "google",
        "country": "de",
        "key": "product",
        "value": "STABILO point 88||STABILO||4006381333962||||",
        "topic": "search",
        "max_pages": 1,
        "max_age": 1200
      },
      "content": {
        "product_id": "1570378438328501500",
        "identity": "catalogid:1570378438328501500,query:STABILO point 88",
        "name": "Fineliner STABILO point 88",
        "brand_name": "STABILO",
        "description": "Der Fineliner STABILO point 88 im Etui überzeugt durch seine präzise, metallgefasste Spitze mit einer Stärke von 0,4 mm, die auch für den Einsatz mit Schablonen geeignet ist. Die Tinte auf Wasserbasis ist in 8 Farben sortiert und lichtbeständig. Ein weiterer Vorteil des STABILO point 88 Fineliners ist, dass er einige Tage offen liegen bleiben kann, ohne einzutrocknen. Die Kappe lässt sich am Stiftende aufstecken und ist farblich passend zur jeweiligen Schreibfarbe gestaltet. Der Schaft des Fineliners ist orange mit weißen Kantenstreifen und besitzt eine Griffzone aus Kunststoff. Das Etui enthält insgesamt 8 Stifte des STABILO point 88 und eignet sich damit ideal für vielfältige Schreib- und Zeichenaufgaben in unterschiedlichen Farben.",
        "url": "https://www.google.de/search?ibp=oshop&q=STABILO+point+88&prds=catalogid:1570378438328501500&gl=de&hl=de&uule=w+CAIQICIHR2VybWFueQ",
        "rating": 0,
        "rating_count": 0,
        "price_avg": 6.64,
        "price_max": 8,
        "price_min": 5.36,
        "offers_count": 5,
        "total_offers_count": 44,
        "offers": [
          {
            "name": "STABILO - Fineliner - point 88 | 8er Pack",
            "price": 5.93,
            "currency": "EUR",
            "shipping": 0,
            "total": 5.93,
            "seller_name": "Amazon.de - Amazon.de-Seller",
            "seller_url": "https://www.amazon.de",
            "url": "https://www.amazon.de/Fineliner-STABILO-point-verschiedenen-Farben/dp/B08YFBLP4Z?source=ps-sl-shoppingads-lpcontext&ref_=fplfs&psc=1&smid=A2LZXSFK6LSJD5",
            "seller_rating": null,
            "seller_rating_count": null,
            "marketplace_name": "N/A",
            "seller_type": "standalone-shop"
          },
          {
            "name": "STABILO point 88 neue Farben sortiert, 8er-Set, Kunststoffetui (88/8-04)",
            "price": 5.93,
            "currency": "EUR",
            "shipping": 0,
            "total": 5.93,
            "seller_name": "Geizhals Preisvergleich",
            "seller_url": "https://geizhals.de",
            "url": "https://geizhals.de/stabilo-point-88-2021-farben-sortiert-88-8-04-a2619174.html?hloc=de&hloc=at&nocookie=1&highlight=409480119035&mtm_campaign=css&mtm_kwd=2619174&mtm_source=google_css&gcsscid=1",
            "seller_rating": null,
            "seller_rating_count": null,
            "marketplace_name": "N/A",
            "seller_type": "standalone-shop"
          },
          {
            "name": "STABILO point 88 Fineliner - 0,4 mm - 8er Etui",
            "price": 5.36,
            "currency": "EUR",
            "shipping": 0,
            "total": 5.36,
            "seller_name": "Bürohengst",
            "seller_url": "https://www.buerohengst.com",
            "url": "https://www.buerohengst.com/stabilo-point-88-fineliner-0-4-mm-8er-etui",
            "seller_rating": 4.698,
            "seller_rating_count": 1478,
            "marketplace_name": "N/A",
            "seller_type": "standalone-shop"
          },
          {
            "name": "Fineliner STABILO point 88",
            "price": 8,
            "currency": "EUR",
            "shipping": 4.95,
            "total": 12.95,
            "seller_name": "stabilo.com",
            "seller_url": "https://www.stabilo.com",
            "url": "https://www.stabilo.com/de/fineliner-stabilo-point-88/eo88-8-04",
            "seller_rating": 0,
            "seller_rating_count": 0,
            "marketplace_name": "N/A",
            "seller_type": "standalone-shop"
          },
          {
            "name": "STABILO Fineliner point 88",
            "price": 7.99,
            "currency": "EUR",
            "shipping": 3.95,
            "total": 11.94,
            "seller_name": "Thalia.de",
            "seller_url": "https://www.thalia.de",
            "url": "https://www.thalia.de/ul/shop/home/artikeldetails/A1060621280",
            "seller_rating": 4.756,
            "seller_rating_count": 989,
            "marketplace_name": "N/A",
            "seller_type": "standalone-shop"
          }
        ],
        "currency": "EUR"
      },
      "success": true,
      "updated_at": "2026-09-14T08:56:48.497Z",
      "trust": {
        "score": 0.98,
        "components": {
          "identity": 0.9099999999999999,
          "completeness": 1,
          "price_integrity": 1,
          "offer_contamination": 1,
          "freshness": 1
        },
        "flagged_offers": []
      },
      "served_from": "live",
      "observed_at": "2026-09-14T08:56:48.468Z"
    }
  ]
}

The trust block is explained in Confidence score; served_from and observed_at in Audit & provenance.