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
Grok 4 credits State targeting (+2), 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
Grok ✅ Yes None (included by default) Included in base price
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
Grok ✅ 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:

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:

  1. 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.
  2. 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.
  3. 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.
  4. HTML proof. Request include.html: true and 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.