Welcome to cloro
cloro is a REST API for capturing how AI assistants and AI-powered search answer your prompts, returning each response as clean, parsed structured data.
Overview
Modern discovery increasingly runs through AI assistants and AI answer boxes rather than a traditional list of blue links. cloro lets you observe that layer programmatically: send a prompt to a supported provider and receive the model's answer already parsed into markdown, together with the sources and citations it drew from. A single, consistent request and response shape covers every provider, so you can compare answers across ChatGPT, Perplexity, Copilot, Grok, Gemini, Google Search, and Google AI Mode without rewriting your integration for each one.
Every provider is reached through a dedicated endpoint under the same base URL, and you can target a specific country or region to see how answers shift by locale.
Request parameters
| Field | Type | Description |
|---|---|---|
| prompt | string | The question or instruction to submit to the provider. Required. |
| country | string | ISO country code (for example US) used to localize the request. Optional; defaults to a global region when omitted. |
Authentication
Requests are authorized with a bearer token. Include your key in the Authorization header and send the body as JSON:
curl -X POST "https://api.cloro.cloud/v1/monitor/chatgpt" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "What do you know about Acme Corp?",
"country": "US"
}'Available endpoints
Each provider has its own POST /v1/monitor/* endpoint. Pick the one that matches the surface you want to observe.
| Endpoint | Provider | Well suited to |
|---|---|---|
/v1/monitor/chatgpt | ChatGPT | Shopping and product-related answers |
/v1/monitor/copilot | Microsoft Copilot | Microsoft ecosystem queries |
/v1/monitor/perplexity | Perplexity | Up-to-date research questions |
/v1/monitor/grok | Grok | Current events and news |
/v1/monitor/google | Google Search | SEO and market research |
/v1/monitor/google-news | Google News | Media and news monitoring |
/v1/monitor/gemini | Google Gemini | General reasoning tasks |
/v1/monitor/aimode | Google AI Mode | General knowledge lookups |
/v1/google/ai-overview | Google AI Overview | Analyzing AI Overview results |
Response example
A successful call returns the parsed answer, the provider queried, and the citations behind it.
{
"provider": "chatgpt",
"country": "US",
"prompt": "What do you know about Acme Corp?",
"answer": "Acme Corp is a manufacturer of industrial hardware...",
"citations": [
{
"title": "About Acme Corp",
"url": "https://example.com/about"
}
],
"created_at": "2026-08-14T09:12:44Z"
}Why cloro
- Parsed, structured output — answers arrive as markdown with their sources and citations attached, ready to store or analyze.
- Many providers, one contract — ChatGPT, Perplexity, Copilot, Grok, Gemini, Google Search, Google News, and Google AI Mode share the same request and response shape.
- Locale-aware — target specific countries to understand how AI answers differ from one market to the next.
- Plain REST and JSON — no SDK required to get started.
Notes
Manage your API key and billing from the dashboard, and reach the team at [email protected] if you need help.