Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cloro.dev/llms.txt

Use this file to discover all available pages before exploring further.

This section documents the shopping cards data returned by the Google Search endpoint. Shopping cards are part of the same response, so no separate API call is needed.

​
Overview

Shopping cards are extracted from Google’s organic shopping grids (“Popular products” and “More products”) when they appear on the SERP. When a section header can be parsed, each card includes a category field naming its parent section, so callers can distinguish cards from coexisting shopping panels on the same SERP. The wire shape borrows fields from AI Mode’s shopping_cards for cross-API familiarity but uses camelCase keys (productLink, oldPrice) emitted by the Google mapper. The shoppingCards field is omitted from result when no shopping section is present — treat it as optional rather than expecting an empty array.
Shopping cards on the Google SERP
productLink is JS-hydrated by Google, so it is usually an empty string in the static HTML response — the card opens a Google-side sidebar overlay rather than navigating externally. The title, price, store, and other static fields remain populated.

​
Shopping card structure

FieldTypeDescription
titlestringProduct title
productLinkstringDirect product URL (usually empty due to JS-hydration)
categorystringParent section header (e.g., "Popular products", "More products")
priceobjectStructured pricing with value and currency
oldPriceobjectOriginal price before discount (same shape as price)
storestringMerchant/store name
ratingnumberProduct rating
reviewsstringReview count (e.g., “384”, “2.3k”)
thumbnailstringProduct image URL

​
price and oldPrice

FieldTypeDescription
valuenumberNumeric price
currencystringCurrency symbol

​
Response example

{
  "success": true,
  "result": {
    "shoppingCards": [
      {
        "title": "ASICS Women's Gel-Nimbus 28",
        "productLink": "",
        "category": "More products",
        "price": {
          "value": 169.99,
          "currency": "$"
        },
        "store": "DICK'S Sporting Goods",
        "rating": 4.5,
        "reviews": "384"
      }
    ]
  }
}