AI Mode is Google's end-state for search — a full conversational results page. cloro returns its source cards and inline citation pills as structured JSON, with city-level geo via location/uule and desktop/mobile targeting. If organic clicks are moving anywhere, they're moving here — measure your share of it.
4.8 · 33 reviews
Sources and citation pills are included in the base 4-credit request; AI Mode also supports location/uule and device like the classic SERP endpoint.
import requests
response = requests.post(
"https://api.cloro.dev/v1/monitor/aimode",
headers={
"Authorization": "Bearer sk_live_your_api_key_here",
"Content-Type": "application/json"
},
json={
"prompt": "best project management tool for remote teams",
"country": "US",
"device": "desktop",
"include": {
"markdown": True
}
}
)
print(response.json()){
"success": true,
"result": {
"text": "For remote teams, the tools that come up most consistently are...",
"markdown": "**For remote teams**, the tools that come up most consistently are...",
"sources": [
{
"position": 1,
"url": "https://example.com/remote-pm-tools",
"label": "Project Management Tools for Remote Teams",
"description": "Deep comparison of 14 PM tools for distributed work"
}
],
"citationPills": [
{
"label": "Project Management Tools for Remote Teams",
"citationPillId": 1,
"url": "https://example.com/remote-pm-tools",
"domain": "example.com",
"position": 1
}
]
}
} | Field | Type | Description |
|---|---|---|
| sources[].position | number | Position index of the source in the response. |
| sources[].url / label / description | string | Cited URL, display label, and source description. |
| citationPills[].citationPillId | integer | 1-based identifier shared by all entries from the same inline chip — group by it to reconstruct pills. |
| citationPills[].position | integer | 1-based pointer to the matching entry in result.sources. |
| citationPills[].domain | string | Host extracted from the URL, for grouping and display. |
Pick a plan that fits your volume. Price per credit drops as you scale.
Increased concurrency, overages on credits and credit discounts for annual contracts.
Know moreCredit cost per request varies by provider. The rates below apply to async/batch requests; sync requests add a +2 credit surcharge.
ChatGPT full response includes query fan-out, ads, and shopping data. Google News uses the same pricing as Google Search.
AI Overview is a block at the top of the classic SERP; AI Mode is a separate conversational results experience that replaces the ten blue links entirely. They cite differently, so track both: this endpoint for AI Mode, the AI Overview API for the SERP block.
AI Mode inherits Google's location model, and answers for commercial and local prompts shift by city, not just country. Use `location` (canonical Google location name) or `uule` — the same geo controls as the SERP API.
Base requests are 4 credits with sources, citation pills, and markdown included — shopping cards too when AI Mode renders them. See pricing for the full table.
AI Mode is a full results surface: the response can carry places, shoppingCards, inlineProducts, videos, map entries, and an ads block when Google renders them — all structured, no extra flags.
Run the same prompt set through ChatGPT, Perplexity, Gemini, and Copilot — the parallel response shapes make cross-engine citation-share dashboards a join, not a rewrite.