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 AI Mode endpoint. Shopping cards are part of the AI Mode response, so no separate API call is needed.

​
Example request

Shopping cards are intent-detected. Send a prompt that expresses shopping intent (for example, asking for products, prices, or where to buy). No flag is required. 
{
  "prompt": "best wireless headphones under $200",
  "country": "US"
}
This produces a response containing the shopping_cards array documented below.

​
Overview

Shopping product information extracted from the response when AI Mode detects shopping intent.
Shopping cards in AI Mode
For individual product references embedded inline within the AI response text (rather than in a dedicated carousel), see inline products. Both arrays may appear in the same response.

​
Shopping card structure

FieldTypeDescription
titlestringProduct title
priceobjectStructured pricing with value and currency
storestringMerchant/store name
ratingnumberProduct rating
reviewsstringReview count (e.g., “2.3k”)
thumbnailstringProduct image URL
product_linkstringDirect product URL
old_priceobjectOriginal price before discount (same shape as price)
snippetstringProduct description snippet
snippet_linksarrayLinks found within the product snippet

​
price and old_price

FieldTypeDescription
valuenumberNumeric price
currencystringCurrency symbol
FieldTypeDescription
textstringLink text
linkstringLink URL

​
Response example

{
  "success": true,
  "result": {
    "text": "Here are highly-rated wireless headphones under $200...",
    "shopping_cards": [
      {
        "title": "Sony WH-CH720N Noise Cancelling Headphones",
        "price": {
          "value": 149.99,
          "currency": "$"
        },
        "old_price": {
          "value": 199.99,
          "currency": "$"
        },
        "store": "Amazon",
        "rating": 4.5,
        "reviews": "2.3k",
        "thumbnail": "https://example.com/product.jpg",
        "product_link": "https://www.amazon.com/sony-wh-ch720n",
        "snippet": "Noise-canceling wireless headphones with 30-hour battery life",
        "snippet_links": [
          {
            "text": "noise canceling",
            "link": "https://www.google.com/search?q=noise+canceling"
          }
        ]
      }
    ]
  }
}