Skip to main content
Get live updates of our changelog on your Slack with our RSS feed.
18th December 2025
Added 11 new countriesExpanded our geographical coverage with 11 new countries available for monitoring:
BD - Bangladesh
CO - Colombia
EG - Egypt
FI - Finland
HK - Hong Kong
KZ - Kazakhstan
NG - Nigeria
PH - Philippines
PK - Pakistan
VE - Venezuela
VN - Vietnam
Most new locations start with low capacity, which will be increased based on demand. Remember to check the model-specific country list before deploying to ensure availability for your target endpoint.
17th December 2025
Defined async task retention policyCOMPLETED and FAILED async tasks are stored for 24 hours after completion.HTML URLs also expire after 24 hours from generation (aligned with task retention).
16th December 2025
More fields extracted for AI Mode and AI OverviewGoogle AI Mode and AI Overview endpoints now automatically extract rich structured data:
  • Places in AI Mode: Complete location information with ratings, reviews, price levels, addresses, Google Places IDs, and operating status
  • Shopping cards in AI Mode: Structured product data with currency-aware pricing, merchant details, ratings, and purchase links
  • Video content in AI Overview: Automatic extraction of videos with thumbnails, titles, duration, platform info, and source attribution
No additional parameters required - all structured data is automatically detected and included when available in responses.Learn more in AI Mode and AI Overview.
12th December 2025
Since location availability depends on the model, we have enhanced the /v1/countries endpoint with model filtering:
  • Model-specific filtering - Get countries available for specific AI providers using the model query parameter
  • Supported models - Filter by: aimode, aioverview, chatgpt, copilot, gemini, google, or perplexity
Usage examples:
# Get all countries
curl "https://api.cloro.dev/v1/countries"

# Get countries available for ChatGPT
curl "https://api.cloro.dev/v1/countries?model=chatgpt"

# Get countries available for Perplexity
curl "https://api.cloro.dev/v1/countries?model=perplexity"
Learn more in our countries endpoint documentation.
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:
{
  "prompt": "Explain quantum computing",
  "country": "US",
  "include": {
    "markdown": true
  }
}
Learn more in our Gemini documentation.
18th November 2025
The HTML code is now stored externally to avoid crowding the response payload.Changes:
  • HTML URLs now expire after 24 hours from generation
  • Storage URLs updated to use https://storage.cloro.dev/results/ format
Important note: If you need to preserve HTML content longer than 24 hours, download it promptly after receiving the response.Example response:
{
  "result": {
    "html": "https://storage.cloro.dev/results/c45a5081-808d-4ed3-9c86-e4baf16c8ab8/page-1.html"
  }
}
Learn more in our Making Requests documentation.
17th November 2025
New Google Search endpointWe’re excited to announce the launch of our Google Search endpoint (/v1/monitor/google) for extracting structured data from Google search results.Features:
  • Organic results - Extract titles, links, snippets, and positions from search results
  • People Also Ask - Capture questions and answers with page tracking
  • Related searches - Get related search query suggestions
  • AI Overview - Extract Google’s AI-generated summaries with source attribution (optional)
  • Multi-page scraping - Scrape up to 20 pages per request with the pages parameter
  • Country-specific results - Support for lots of countries with localized search results
  • Hyperlocal targeting - City-specific search results using simple canonical city names with automatic UULE conversion
  • Raw HTML access - Option to retrieve complete page HTML for custom parsing
Usage example:
{
  "query": "best laptops for programming",
  "pages": 3,
  "country": "US",
  "include": {
    "aioverview": {
      "markdown": true
    }
  }
}
Learn more in our Google search documentation.
15th November 2025
Enhanced retry logic for synchronous requestsWe have the following changes in our internal retry mechanism:
  • Increased retry attempts from 5 to 10 for synchronous requests
  • Added 5-minute maximum duration timeout to prevent indefinite waiting
  • Requests canceled by clients are charged for resources consumed (same behavior as before)
This new automatic retry handling eliminates the need for client-side timeout logic. More details in the Error handling section.
14th November 2025
Configurable HTML response for all parsersHTML content in parser responses is now optional and configurable across all monitoring endpoints.Changes:
  • Added include.html parameter to all parser endpoints (ChatGPT, Perplexity, Copilot, AI Mode, AI Overview)
  • A URL to the HTML content is now only included when explicitly requested with "include.html": true
  • Responses are smaller and faster when HTML is not needed
  • Markdown conversion continues to work regardless of HTML inclusion
Usage example:
{
  "prompt": "Your query here",
  "include": {
    "html": true,
    "markdown": true
  }
}
This change reduces response sizes and improves performance when the full HTML content is not required by your application.
11th November 2025
Asynchronous requests and webhooksYou can now make asynchronous requests for async tasks. When you make an async request, you’ll receive a taskId, the task will then be processed in the background.You can retrieve the results in two ways:
  • Webhooks: Provide a webhook.url in your request, and we’ll send the results to your endpoint as soon as they’re ready.
  • Polling: Use the new GET /v1/async/task/{taskId} endpoint to check the status of your task and retrieve the results when it’s complete.
This is ideal for serverless environments or applications that can’t wait for a task to complete.Learn more in our Async Requests documentation.
7th November 2025
More information in Perplexity responsePerplexity API endpoint has been significantly expanded to reflect extra fields in the Perplexity response. The endpoint now automatically extracts structured data objects based on query intent:Shopping data extraction:
  • Complete product information with titles, descriptions, pricing, and ratings
  • Multiple merchant offers and availability status
  • Product variants, images, and detailed specifications
  • Shopping cards with promotional tags and categorization
Media content extraction:
  • Video content with thumbnails, dimensions, and source attribution
  • Image extraction with metadata and sizing information
  • Support for YouTube, stock photos, and other media platforms
Travel and location data:
  • Hotel listings with ratings, reviews, amenities, and pricing
  • Place information with categories, coordinates, and contact details
  • Address data, map URLs, and image galleries
Enhanced search intelligence:
  • Related query suggestions for follow-up searches
  • Internal search query tracking showing how responses are generated
  • Advanced citation processing and source attribution
The documentation now provides complete schema definitions for all response objects, including field types, descriptions, and examples. No API changes were required - these features were already available and are now properly documented.Learn more in the updated Perplexity API documentation.
6th November 2025
Entity extraction for ChatGPTChatGPT responses now include automatic entity extraction when specific items, products, brands, or concepts are identified. This feature provides structured data objects for:
  • Product Recognition: Automatically identify and extract product mentions
  • Brand Tracking: Monitor brand references across ChatGPT responses
  • Concept Analysis: Extract named entities for semantic analysis
  • Content Classification: Categorize response content based on extracted entities
Each entity includes:
  • Type: Entity type identifier (e.g., “product”, “software”)
  • Name: Entity name or title (e.g., “adidas Grand Court Lo”, “Nike Dunk Low Retro SE”)
Entity extraction works alongside shopping cards to provide comprehensive structured data extraction from ChatGPT responses. No additional parameters are required - entities are automatically detected and included when available.Learn more in our ChatGPT documentation.
1st November 2025
Shopping Cards for ChatGPTChatGPT responses now automatically include structured shopping cards when product information is detected. This feature enables:
  • Product Monitoring: Track prices, ratings, and availability over time
  • Price Tracking: Monitor price changes across different regions
  • Competitive Intelligence: Extract structured product data for analysis
  • Commerce Integration: Build price comparison and recommendation systems
Shopping cards include comprehensive product details:
  • Product Information: Name, brand, description, detailed specifications
  • Pricing Data: Current price, original price, discount information
  • Commercial Details: Multiple merchant offers, availability, checkout options
  • Media Assets: Product images, checkout-specific images
  • Social Proof: Ratings, review counts, rating citations with sources
  • Offer Details: Merchant-specific pricing, promotional tags, shipping costs
The shopping cards feature supports:
  • Multi-offer products: Compare different merchants for the same product
  • Price breakdown: Detailed pricing including base, shipping, tax, and total
  • Promotional content: Tags, tooltips, and special offers
  • Rich media: Multiple product images and checkout assets
  • Availability tracking: Real-time stock and checkout status
No additional parameters are required - shopping cards are automatically detected and included when available.Learn more in our ChatGPT documentation.
31st October 2025
New dedicated endpointsEach AI model now has its own dedicated endpoint for better performance and clearer documentation:
27th October 2025
Added Google AI OverviewGoogle AI Overview is now supported. You can extract structured data from AI-generated summaries that appear at the top of Google search results.To monitor AI Overview, set "model": "AIOVERVIEW" in your API requests:
{
  "prompt": "What are the best electric vehicles in 2025?",
  "model": "AIOVERVIEW",
  "country": "US"
}
All existing features work with AI Overview, including:
  • Structured data extraction with sources & citations
  • Localization across different countries
  • Markdown format support
Learn more in our API reference.
18th October 2025
Added Google AI ModeGoogle’s AI Mode results are now supported. You can extract structured data from ChatGPT, Perplexity, Copilot, and AI Mode using the same unified interface.To monitor AI Mode, set "model": "AIMODE" in your API requests:
{
  "prompt": "What do you know about Acme Corp?",
  "model": "AIMODE",
  "country": "US"
}
All existing features work with AIMODE, including:
  • Structured data extraction with sources & citations
  • Localization across different countries
  • Markdown format support
  • Citation grouping and processing
Learn more in our API Reference.
17th October 2025
Added include.rawResponse parameterYou can now access the underlying AI provider payload in monitoring responses (ChatGPT-only). Enable it with "include.rawResponse": true to receive the full provider response alongside cloro’s structured output.
{
  "prompt": "What do you know about Acme Corp?",
  "model": "CHATGPT",
  "include": {
    "markdown": true,
    "rawResponse": true
  }
}
Learn more in our API Reference.
16th October 2025
Added Microsoft CopilotMicrosoft Copilot (formerly Bing Chat) is now supported. You can now extract structured data from ChatGPT, Perplexity, and Copilot using the same unified interface.To use Copilot, simply set "model": "COPILOT" in your API requests:
{
  "prompt": "What do you know about Acme Corp?",
  "model": "COPILOT",
  "country": "US"
}
All existing features work with Copilot, including:
  • Structured data extraction with sources & citations
  • Localization across different countries
  • Markdown format support
  • Citation grouping and processing
Learn more in our API Reference.
15th October 2025
Added PerplexityPerplexity is now supported. You can now extract structured data from both ChatGPT and Perplexity models using the same unified interface.To use Perplexity, simply set "model": "PERPLEXITY" in your API requests:
{
  "prompt": "What do you know about Acme Corp?",
  "model": "PERPLEXITY",
  "country": "US"
}
All existing features work with Perplexity, including:
  • Structured data extraction with sources & citations
  • Localization across different countries
  • Markdown format support
Learn more in our API Reference.
14th October 2025
Added searchQueries field to responsesAll AI monitoring responses now include a searchQueries field that shows the search terms used to generate the AI response.
{
  "success": true,
  "result": {
    "text": "The name \"Acme Corporation\" is used in various contexts...",
    "searchQueries": [
      "What is Acme Corporation?",
      "Acme Corp company overview",
      "Acme Corporation products and services"
    ]
  }
}
Learn more in our API Reference.
11th October 2025
Added include.markdown parameterYou can now receive markdown-formatted content in AI monitoring responses. Perfect for documentation workflows and content management systems.
{
  "prompt": "What do you know about Acme Corp?",
  "model": "CHATGPT",
  "include": {
    "markdown": true
  }
}
Learn more in our API Reference.
9th October 2025
🎉 cloro API LaunchOur AI monitoring API is now live! Extract structured data from ChatGPT, Perplexity, Microsoft Copilot, Google AI Mode and other AI models about your brand or any topic across different regions.Key features:
  • AI response monitoring across different countries
  • Structured data extraction with sources and citations
  • Support for text and HTML formats
  • Real-time AI model tracking
Get started with our welcome guide or explore the API reference.