Supported AI providers, features, and credit pricing - cloro
Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
cloro extracts structured data from multiple providers. Each request costs credits based on the provider and the features you enable.
Provider list and base costs
| Provider | Base Cost | Key Features |
|---|---|---|
| ChatGPT | 5 credits ( see details) | Shopping cards & inline products (+2), query fan-out (+2), raw response (+2), ads (+2), state targeting (+2), map entries, citation pills |
| AI Overview | 5 credits | Part of Google Search endpoint, ads included |
| Gemini | 4 credits | State targeting (+2), markdown & HTML included |
| AI Mode | 4 credits ( see details) | Shopping cards, markdown included, expanded product results (+1 per cluster) |
| Perplexity | 4 credits | State targeting (+2), shopping cards, query fan-out, markdown included |
| Copilot | 5 credits | State targeting (+2), shopping cards, query fan-out, markdown included |
| Google Search | 3 credits ( see details) | AI Overview and/or PAA AI Overview (+2 total), ads, multi-page (+2 per additional page) |
| Google News | 3 credits | Multi-page (+2 per additional page, same as Google Search) |
Grok is temporarily unavailable
Grok has blocked anonymous access for the time being. Requests to the Grok endpoint will fail.
Detailed pricing
Sync request surcharge
All sync monitor requests (/v1/monitor/*) include a +2 credit surcharge on top of the base cost and any feature add-ons. Async and batch requests (/v1/async/*) are not affected.
Google Search multi-page pricing
| Feature | Cost |
|---|---|
| Base request (page 1) | 3 credits |
| + AI Overview | +2 credits |
| + PAA AI Overview | +2 credits |
| Any combination of AI Overview and PAA AI Overview | +2 credits |
| + Each additional page (pages 2-10) | +2 credits per page |
| 3 pages with AI Overview | 9 credits |
| 10 pages with AI Overview | 23 credits |
HTML responses are included at no additional cost. Maximum 10 pages per request. Google News uses the same multi-page pricing, without the AI Overview option. Read X-Credits-Charged on the response for the exact charge of a request.
ChatGPT additional features
| Feature | Cost |
|---|---|
| Base request (web search enabled) | 5 credits |
| + Raw response | +2 credits |
| + Query fan-out | +2 credits |
| + Ads | +2 credits |
+ Shopping cards & inline products (include.shopping) |
+2 credits |
| Any combination of raw response, query fan-out, ads, and shopping | +2 credits |
| Full response | 7 credits |
AI Mode additional features
| Feature | Cost |
|---|---|
| Base request | 4 credits |
+ Expanded product results (include.expandProducts) |
+1 credit per product cluster returned (max +6) |
Setting include.expandProducts: true returns a productResults array with per-merchant offers for each product cluster. The surcharge scales with the clusters Google actually returns — three clusters cost 4 + 3 = 7 credits, none costs the base 4. Expansion covers at most 6 clusters per scrape, so the ceiling is 10 credits. The charge is applied after the scrape completes and appears in X-Credits-Charged on sync responses.
Feature comparison
Query fan-out support
Query fan-out reveals the search queries that providers use internally to gather information. Useful for understanding how models break down complex prompts.
| Provider | Support | Request Parameter | Cost |
|---|---|---|---|
| ChatGPT | ✅ Yes | include.searchQueries: true |
+2 credits |
| Perplexity | ✅ Yes | None (included by default) | Included in base price |
| Copilot | ✅ Yes | None (included by default) | Included in base price |
| Gemini | ❌ No | - | - |
| AI Overview | ❌ No | - | - |
| AI Mode | ❌ No | - | - |
AI Overview and AI Mode do not expose result.searchQueries. Google does not include that data in the rendered HTML it serves to anonymous users.
Shopping cards support
Shopping cards provide structured product information including pricing, ratings, offers, and merchant details.
| Provider | Support | Cost | Notes |
|---|---|---|---|
| ChatGPT | ✅ Yes | +2 credits | Opt-in with include.shopping: true. Includes inline products |
| Perplexity | ✅ Yes | Included | Automatically extracted when available |
| Copilot | ✅ Yes | Included | Automatically extracted when available |
| AI Mode | ✅ Yes | Included | Automatically extracted when available |
| Grok | ❌ No | - | - |
| Gemini | ❌ No | - | - |
| AI Overview | ❌ No | - | - |
Cards only appear when the prompt is product-related and the provider returns product data — even then they aren’t guaranteed. See Why aren’t shopping cards appearing in my responses? for prompt examples.
Ads support
Ads extraction provides structured advertising data from provider responses, including advertiser branding, destination URLs, and product carousel cards.
| Provider | Support | Cost | Notes |
|---|---|---|---|
| ChatGPT | ✅ Yes | +2 credits | Opt-in with include.ads: true. Brand info and carousel cards |
| Google Search | ✅ Yes | Included | Always included. Sponsored ads with sitelinks |
| AI Overview | ✅ Yes | Included | Always included. Text and shopping ads within AI Overview |
| Perplexity | ❌ No | - | - |
| Copilot | ❌ No | - | - |
| Grok | ❌ No | - | - |
| Gemini | ❌ No | - | - |
| AI Mode | ❌ No | - | - |
State-level targeting
Pass the USPS two-letter code as state alongside country: "US" to target a specific state:
{
"prompt": "best electricians near me",
"country": "US",
"state": "TX"
}
Call GET /v1/states?country=US for the full list of codes (50 states + DC).
| Provider | Support | Cost |
|---|---|---|
| ChatGPT | ✅ Yes | +2 credits |
| Copilot | ✅ Yes | +2 credits |
| Perplexity | ✅ Yes | +2 credits |
| Gemini | ✅ Yes | +2 credits |
| Google Search | ❌ No | — |
| AI Overview | ❌ No | — |
| AI Mode | ❌ No | — |
| Google News | ❌ No | — |
Google Search, AI Overview, and AI Mode use location / uule for sub-country targeting instead. Google News supports country only — it has no sub-country targeting.
Other features
| Feature | Providers | Cost | Notes |
|---|---|---|---|
| Sources | All | Included | All providers include source citations |
| HTML responses | All | Included | Use include.html: true |
| Markdown format | All | Included | Use include.markdown: true |
| Entity extraction | ChatGPT | Included | Products, brands, and concepts mentioned in responses |
| Map entries | ChatGPT, Copilot | Included | Business/place information |
| Citation pills | ChatGPT, Google AI Overview, AI Mode, Copilot, Perplexity, Gemini | Included | Inline citations denormalized one entry per cited source, sharing a citationPillId per chip. Not available on Grok (no inline citations upstream) |
| Related links | Google AI Overview | Included | A chip’s “View related links” flyout URLs that are not in sources, grouped with their pill via citationPillId. See AI Overview schema |
| Raw response | ChatGPT | +2 credits | Full streaming events with include.rawResponse: true |
Unsupported providers
cloro does not currently scrape the following providers. The list covers the most common requests we receive and is updated as coverage changes.
| Provider | Supported? | Reason |
|---|---|---|
| Mistral | ❌ No | No endpoint available today. We evaluate new providers regularly based on demand |
| Claude | ❌ No | Behind a login wall — access conflicts with Anthropic’s terms of service |
| Meta AI | ❌ No | Behind a login wall — access conflicts with Meta’s terms of service |
| DeepSeek | ❌ No | Behind a login wall — access conflicts with DeepSeek’s terms of service |
| Amazon Rufus | ❌ No | Behind a login wall — access conflicts with Amazon’s terms of service |
To request a provider, let us know at r/cloroapi. We cannot commit to dates and will not scrape services that require authentication.
Common questions
How does cloro retrieve data from AI providers?
cloro retrieves data from AI surfaces (ChatGPT, Perplexity, Copilot, Gemini, etc.) using real browser sessions routed through proxy infrastructure — not direct API calls. Key implications:
- Geo proxy routing: each request routes through a proxy in the country (and, for US requests on supported providers, the state) you specify — the AI provider sees that location’s anonymous user.
- Model routing: cloro does not control which model the provider uses; that is the provider’s decision (e.g., ChatGPT cycles between
gpt-5-3andgpt-5-3-minibased on its own logic). - Authentication walls: cloro uses logged-out sessions — no account of any kind, free or paid — so responses reflect what an unauthenticated visitor sees. cloro cannot access content that requires a logged-in session. If a provider begins requiring login in a region, requests from that region will fail until the provider relaxes the requirement.
- Response fidelity: the
htmlfield is the actual page the provider rendered;result.*fields are extracted from that page.
Does the country parameter change the response language?
No. country controls geo-routing, not language. Most providers infer language from the prompt itself, so to get a Spanish response from a Mexico-targeted request, write the prompt in Spanish. Mixed-language prompts (English prompt + non-English country) often work but can produce inconsistent localization — for best results, match the prompt language to the target country.
I targeted one country but the response references another — is the proxy broken?
Almost always the proxy applied correctly and what you’re seeing is model behavior, not routing:
- Pre-trained answers leak through. A model trained heavily on US English content sometimes defaults to US-centric references even when served from another region. The proxy was applied; the model ignored the regional context.
- The prompt overrides the geography. A prompt like “best pizza in Cincinnati” returns Cincinnati results from any proxy. The location affects what the search layer sees, not what the user asked for.
- Sources are the strongest signal. Inspect
result.sources. Sources from the targeted country’s domains (.de,.fr,.com.ua) confirm the proxy worked. Diverse sources with US-centric prose is model bias, not a routing bug. - HTML proof. Request
include.html: trueand inspect the rendered page — the chrome (language, currency, regional UI) reflects where the request was actually made from.
If sources, HTML chrome, and response language all point to the wrong region, open a support ticket with the taskId and the country you submitted.
A country worked last month but now returns 400 errors. What changed?
Provider availability shifts week to week as upstream products roll out regional changes. Refresh GET /v1/countries?model=<provider> before assuming a regression — the supported list is the source of truth and it does change. If the country still appears in the list but requests keep failing, reach out with the taskId — paid plans via the in-dashboard support widget, free tier via the Ask Assistant button in these docs.
Why is ChatGPT (or Copilot) suddenly failing for a specific country?
Some AI providers intermittently require login for anonymous users in specific regions, blocking the anonymous session cloro uses. This is not a cloro infrastructure issue — it resolves when the provider adjusts its regional access controls, on a timeline cloro does not control. If your failure rate from a specific country consistently exceeds ~30%, reach out — paid plans via the in-dashboard support widget, free tier via the Ask Assistant button in these docs. The status page (status.cloro.dev) does not track per-region provider breakdowns.
Why aren’t shopping cards appearing in my responses?
Shopping cards only appear when the prompt is related to products or shopping:
# ✅ Good - shopping related
"best laptops under $1000"
"compare iPhone vs Samsung"
"top rated headphones 2026"
# ❌ Bad - not shopping related
"what is the capital of France"
"how does photosynthesis work"
Bear in mind that the provider must support shopping cards (ChatGPT, Perplexity, Copilot, or AI Mode).
Do you support Claude, Mistral, Meta AI, DeepSeek, or Amazon Rufus?
No. See Unsupported providers above for the current list and reasons.