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 mirrors the common subset of AI Mode’s shopping_cards for cross-API parity. 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
product_link is JS-hydrated by Google, so it may be an empty string in the static HTML response. The title, price, store, and other static fields remain populated.

​
Shopping card structure

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

​
price and old_price

FieldTypeDescription
valuenumberNumeric price
currencystringCurrency symbol

​
Response example

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