6th February 2026
Isolation of ChatGPT citation dataWe’ve improved how source information is structured and exposed in ChatGPT responses:Citation pills: Inline citations that appear within ChatGPT responses where specific sources are referenced. Each citation pill includes:
- URL: Direct link to the cited source
- Label: Title or label of the citation
- Description: Summary of the cited content
- Domain: Source domain (e.g., “example.com”)
- Date published: ISO 8601 date string when the source was published
- Citation pill ID: Unique identifier for the citation
sources array now includes a footnote boolean field that indicates whether a source appears in main window footnote (i.e., the sources pill), helping distinguish between primary and secondary sources.Previously, the citation and source pill data was only accessible by parsing the markdown response. Now you can access it directly through structured JSON objects without needing to parse markdown links.No additional parameters required - citation pills and the footnote field are automatically included when available in ChatGPT responses.Learn more in our ChatGPT documentation.5th February 2026
Updated Google Search pricing structureWe’ve updated the Google Search endpoint baseline pricing to a more predictable tiered structure for multi-page requests.What’s changed:
- Multi-page pricing is now tiered instead of per-page:
- 2-3 pages: +1 credit (was +2-4 credits)
- 4-10 pages: +2 credits (was +6-18 credits)
- Base cost and AI Overview remain unchanged:
- Base request: 3 credits
- AI Overview addon: +2 credits
- 1 page, no AI Overview: 3 credits (unchanged)
- 1 page, with AI Overview: 5 credits (unchanged)
- 3 pages, with AI Overview: 6 credits (was 9 credits)
- 10 pages, with AI Overview: 7 credits (was 23 credits)
3rd February 2026
Map entries for ChatGPTChatGPT responses now automatically include structured map entries when business or place information is detected. This feature enables:
- Local business monitoring: Track restaurants, stores, and service providers
- Location intelligence: Extract ratings, reviews, and contact details
- Competitive analysis: Monitor local businesses across different regions
- Directory building: Create structured business listings
- Business information: Name, category, description
- Social proof: Rating score, review count
- Contact details: Website URL, phone number
- Location data: Position/ranking in results
- Navigation: Directions URL (when available)
31st January 2026
Added 16 new countriesWe’ve expanded our geographical coverage with 16 new countries available for monitoring across all non-Google endpoints:Remember to always check the model-specific country list before deploying to ensure availability for your target endpoint, as some models have country-specific restrictions.
23rd January 2026
Google Search and AI Mode updatesWe’ve updated the Google Search and AI Mode endpoints:Removed parameters:
cityparameter temporarily removed from Google Search and AI Mode endpoints- No customers were using this parameter, and
country-level localization was sufficient for all use cases
deviceparameter added to AI Mode endpoint- Options:
desktop(default) ormobile - Matches the device targeting available in Google Search
20th January 2026
Gemini geographical expansionGemini now supports EU countries and additional regions, bringing geographical coverage to parity with Copilot, Perplexity, and Grok.The countries endpoint remains the authoritative source for current country availability. Always query with
model=gemini to verify supported locations before deploying:15th January 2026
Grok is now availableWe’re excited to announce the addition of Grok as a new provider.Key features:See the Grok API documentation for full details and examples.
- Supported in most countries (remember to check the model-specific country list)
- Enhanced source metadata with preview text, search engine display text, site information, creator details, and image URLs
- Real-time web integration for current information and breaking news
- Response formats: Text, HTML, and Markdown
11th January 2026
We’ve significantly expanded our geographical coverage across all Google endpoints:
- Google Search: Now available in all 250 countries worldwide
- AI Mode: Expanded from 58 to 211 countries
- AI Overview: Expanded from 59 to 230 countries
18th December 2025
Added 11 new countriesExpanded our geographical coverage with 11 new countries available for monitoring: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 policy
COMPLETED 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
12th December 2025
Since location availability depends on the model, we have enhanced the Learn more in our countries endpoint documentation.
/v1/countries endpoint with model filtering:- Model-specific filtering - Get countries available for specific AI providers using the
modelquery parameter - Supported models - Filter by:
aimode,aioverview,chatgpt,copilot,gemini,google, orperplexity
23rd November 2025
We’ve added support for Google Gemini (Learn more in our Gemini documentation.
/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
18th November 2025
The HTML code is now stored externally to avoid crowding the response payload.Changes:Learn more in our Making Requests documentation.
- HTML URLs now expire after 24 hours from generation
- Storage URLs updated to use
https://storage.cloro.dev/results/format
17th November 2025
New Google Search endpointWe’re excited to announce the launch of our Google Search endpoint (Learn more in our Google search documentation.
/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 10 pages per request with the
pagesparameter - 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
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)
14th November 2025
Configurable HTML response for all parsersHTML content in parser responses is now optional and configurable across all monitoring endpoints.Changes:This change reduces response sizes and improves performance when the full HTML content is not required by your application.
- Added
include.htmlparameter 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
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.urlin 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.
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
- Video content with thumbnails, dimensions, and source attribution
- Image extraction with metadata and sizing information
- Support for YouTube, stock photos, and other media platforms
- Hotel listings with ratings, reviews, amenities, and pricing
- Place information with categories, coordinates, and contact details
- Address data, map URLs, and image galleries
- Related query suggestions for follow-up searches
- Internal search query tracking showing how responses are generated
- Advanced citation processing and source attribution
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
- Type: Entity type identifier (e.g., “product”, “software”)
- Name: Entity name or title (e.g., “adidas Grand Court Lo”, “Nike Dunk Low Retro SE”)
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
- 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
- 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
31st October 2025
New dedicated endpointsEach AI model now has its own dedicated endpoint for better performance and clearer documentation:
- Extract Google AI Overview (
POST /v1/monitor/aioverview) - Extract Microsoft Copilot (
POST /v1/monitor/copilot) - Extract Perplexity (
POST /v1/monitor/perplexity) - Extract Google AI Mode (
POST /v1/monitor/aimode) - Extract ChatGPT (
POST /v1/monitor/chatgpt)
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 All existing features work with AIMODE, including:
"model": "AIMODE" in your API requests:- Structured data extraction with sources & citations
- Localization across different countries
- Markdown format support
- Citation grouping and processing
17th October 2025
Added Learn more in our API Reference.
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.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 All existing features work with Copilot, including:
"model": "COPILOT" in your API requests:- Structured data extraction with sources & citations
- Localization across different countries
- Markdown format support
- Citation grouping and processing
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 All existing features work with Perplexity, including:
"model": "PERPLEXITY" in your API requests:- Structured data extraction with sources & citations
- Localization across different countries
- Markdown format support
14th October 2025
Added Learn more in our API Reference.
searchQueries field to responsesAll AI monitoring responses now include a searchQueries field that shows the search terms used to generate the AI response.11th October 2025
Added Learn more in our API Reference.
include.markdown parameterYou can now receive markdown-formatted content in AI monitoring responses. Perfect for documentation workflows and content management systems.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