> ## Documentation Index
> Fetch the complete documentation index at: https://cloro.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use only the endpoint paths in https://cloro.dev/docs/skill.md. Do not derive a path from a docs page URL.
> For many requests, use the async API (POST /v1/async/task or POST /v1/async/task/batch). It has no sync surcharge.
> To call cloro as tools, use the MCP server at https://mcp.cloro.dev/mcp.
> Plan prices are at https://cloro.dev/pricing/. Credits for each request are at https://cloro.dev/docs/guides/providers.md.

# Gemini changelog

> All cloro changelog entries for Gemini, newest first.

See [every entry](https://cloro.dev/docs/changelog.md).

**27th October 2026**

**Gemini: responses about 60% faster**

The [Gemini endpoint](https://cloro.dev/docs/api-reference/endpoint/monitor-gemini.md) now returns a response in about 14 seconds on average, against about 37 seconds before. `include.html` adds about 2 seconds.

**22nd September 2026**

**Gemini product cards now ship as `shoppingCards`**

Gemini shows product cards in shopping answers. Before, the response had no structured data for them. Now each card comes back as an object, with the same field names as AI Mode's `shoppingCards` and more fields that only Gemini supplies:

```json theme={null}
{
  "position": 1,
  "title": "ASICS Men's Novablast 5",
  "productLink": "https://google.com/search?q=ASICS+Men%27s+Novablast+5&prds=...&ibp=oshop",
  "productId": "11413473167792520357",
  "price": { "value": 129.95, "currency": "$", "raw": "$129.95" },
  "oldPrice": { "value": 149.99, "currency": "$", "raw": "$149.99" },
  "store": "Marathon Sports",
  "storeLink": "https://www.marathonsports.com/products/asics-mens-novablast-5",
  "storeCount": 2,
  "shipping": "Free",
  "deliveryTime": "Up to 5 days",
  "rating": 4.8,
  "reviews": 11558,
  "brand": "ASICS",
  "thumbnail": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:example",
  "catalogId": "15000182008314641842",
  "gpcId": "1340101364570861215"
}
```

Cards also carry `description` and `images`. See the [shopping cards schema](https://cloro.dev/docs/api-reference/endpoint/gemini/shopping-cards.md). Shopping cards are intent-detected, so no flag is required and there is no extra cost. `shoppingCards` is absent when the answer has no product cards. `markdown`, `sources` and `places` do not change.

**9th September 2026**

**Gemini place cards now ship as `places`**

Lodging and local answers carry a card carousel. Its photos used to land in `sources` as image URLs while the place itself was dropped; the cards now come back as their own array, and `sources` holds only real citations.

```json theme={null}
{
  "index": 0,
  "title": "Pullman Quay Grand Sydney Harbour",
  "link": "https://www.google.com/travel/search?q=Pullman+Quay+Grand+Sydney+Harbour",
  "rating": 4.4,
  "reviews": 1307,
  "type": "5-star hotel",
  "price": "$565"
}
```

Intent-detected, so no flag is required. See the [places schema](https://cloro.dev/docs/api-reference/endpoint/gemini/places.md).

**24th June 2026**

**State-level geo-targeting for AI endpoints**

You can now target a specific US state when querying ChatGPT, Copilot, Perplexity, Gemini, or Grok. Pass the USPS two-letter code as the `state` parameter alongside `country: "US"` and cloro routes the request through a proxy in that state — giving you localized results at the sub-country level.

```json theme={null}
{
  "prompt": "best electricians near me",
  "country": "US",
  "state": "TX"
}
```

State targeting costs **+2 credits** on top of the base cost and any other add-ons. Use [`GET /v1/states?country=US`](https://cloro.dev/docs/api-reference/endpoint/states) to retrieve the full list of supported state codes. Google Search and AI Mode are not affected — those endpoints continue to use `location` / `uule` for sub-country targeting.

**22nd May 2026**

**Structured `citationPills` now on Perplexity, Copilot, and Gemini**

All three endpoints now emit an additive `citationPills` array alongside the answer text and sources. Combined with the May 21st rollout to Google AI Overview and AI Mode, cross-provider iteration over AI citation pills now works the same way on six endpoints (ChatGPT, Google AI Overview, AI Mode, Perplexity, Copilot, Gemini).

Each entry is one (pill, source) pair carrying a per-source `label` (the source's own page title), a `citationPillId` that groups entries from the same chip, and per-source `url`/`domain`/`description`/`position`.

```json theme={null}
"citationPills": [
  {
    "label": "Best Programming Laptops 2026 — TechCrunch",
    "citationPillId": 1,
    "url": "https://techcrunch.com/laptops",
    "domain": "techcrunch.com",
    "description": "Latest laptop reviews and recommendations",
    "position": 1
  },
  {
    "label": "Wired Laptop Buyer's Guide",
    "citationPillId": 1,
    "url": "https://wired.com/programming-laptops",
    "domain": "wired.com",
    "description": "Programming laptop buyer's guide",
    "position": 3
  }
]
```

All six providers share a common base shape (`label`, `citationPillId`, `url`, `domain`, `description?`, `position`). ChatGPT carries two additional fields (`datePublished?`, `type`) that the other surfaces do not emit. Consumers writing cross-provider citation-pill iteration should treat `datePublished` and `type` as ChatGPT-only, and use `citationPillId` for chip grouping.

Additive change — existing consumers are unaffected. The field is omitted from `result` when the answer carries no pills. Learn more in the per-endpoint citation pills documentation: [Perplexity](https://cloro.dev/docs/guides/providers.md#unsupported-providers), [Copilot](https://cloro.dev/docs/guides/providers.md#unsupported-providers), [Gemini](https://cloro.dev/docs/api-reference/endpoint/gemini/citation-pills.md).

**5th May 2026**

**Gemini sources no longer include `confidence_level`**

Google Gemini stopped returning a confidence score on source citations. The `confidence_level` field has been removed from the [Gemini endpoint](https://cloro.dev/docs/api-reference/endpoint/monitor-gemini.md) response schema. All other source fields (`position`, `url`, `label`, `description`) are unchanged.

**19th March 2026**

**Raw response now available for all event stream engines**

The `rawResponse` field is now available for Copilot, Grok, Gemini, and Perplexity endpoints at no additional cost.

**Example usage:**

```json theme={null}
{
  "prompt": "Your query here",
  "model": "GROK",
  "include": {
    "rawResponse": true
  }
}
```

Raw response data provides full streaming event payloads, so you can see how these AI models generate their responses.

**6th March 2026**

**Massive geographical expansion for Perplexity, Copilot, Gemini, and Grok**

We've expanded country coverage for Perplexity, Copilot, Gemini, and Grok to match the availability of ChatGPT.

**Country coverage by model**:

* **ChatGPT**: 196 countries (unchanged)
* **Perplexity**: 196 countries (expanded from 74)
* **Grok**: 195 countries (expanded from 74)
* **Gemini**: 195 countries (expanded from 73)
* **Copilot**: 193 countries (expanded from 71)
* **AI Mode**: 211 countries (unchanged)
* **AI Overview**: 230 countries (unchanged)
* **Google Search**: 250 countries (unchanged)

The [countries endpoint](https://cloro.dev/docs/api-reference/endpoint/countries.md) remains the authoritative source for current country availability. Always query with your target model to verify supported locations before deploying.

**20th January 2026**

**Gemini geographical expansion**

Gemini now supports EU countries and additional regions, bringing geographical coverage to parity with Copilot, Perplexity, and Grok.

The [countries endpoint](https://cloro.dev/docs/api-reference/endpoint/countries.md) remains the authoritative source for current country availability. Always query with `model=gemini` to verify supported locations before deploying:

```bash theme={null}
curl "https://api.cloro.dev/v1/countries?model=gemini" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**23rd November 2025**

We've added support for Google Gemini (`/v1/monitor/gemini`). You can now extract structured data from Gemini responses with source citations.

**Features**:

* **Text extraction** - Get the generated response text
* **Source citations** - Structured list of sources with URLs, snippets, and confidence levels
* **Markdown & HTML** - Optional output formats

**Usage example**:

```json theme={null}
{
  "prompt": "Explain quantum computing",
  "country": "US",
  "include": {
    "markdown": true
  }
}
```

Learn more in our [Gemini documentation](https://cloro.dev/docs/api-reference/endpoint/monitor-gemini.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.