cloro

• Welcome to cloro: Extract structured data from ChatGPT, Perplexity, Microsoft Copilot, Google AI Mode, Google Search with AI Overview and other AI models

• Quickstart: make your first cloro API request: Get started with the cloro API in minutes. Learn how to get your API key, make your first monitoring request, and understand the response structure.

• Authentication: Learn how to authenticate with the cloro API using Bearer tokens, manage API keys securely, and handle authentication errors in your requests.

• Making requests: Compare the two cloro request modes — synchronous and asynchronous — including credit cost, latency, concurrency limits, and guidance on which mode to use.

• Synchronous requests: Make synchronous requests to the cloro API: request structure, common parameters, response shape, optional formats, and code examples.

• Asynchronous requests: Submit async tasks to cloro: submit-and-fetch flow, webhooks vs polling, task states, priority, queue limits, and clearing queued jobs.

• Webhooks: Receive async task results via webhooks: payload shape, retry behavior, HMAC signature verification in Node.js, Python, and Go, and troubleshooting tips.

• Error handling: Understanding API errors, HTTP status codes, error response formats, retry logic, and troubleshooting strategies for all cloro monitoring endpoints.

• Versioning and deprecation: How the cloro API is versioned, which changes ship without warning, how a deprecation is announced, and what the Deprecation and Sunset headers tell you.

• Rate & concurrency limits: Understand cloro's rate and concurrency limits, read the response headers, and process many requests efficiently with async patterns and concurrent workers.

• Supported AI providers, features, and credit pricing: Compare cloro provider support across ChatGPT, Gemini, Copilot, Perplexity, Grok, Google AI Mode, and Google Search, including features and credit costs.

• Billing & credits: cloro subscription plans, monthly credit allocation and expiration, billing cycles, invoices, enterprise contracts, and how to manage your subscription.

• Account & organizations: How cloro user accounts and organizations relate, how to manage team members, and how to delete either from the dashboard and what that removes.

• Output formats: Learn how to render proof-of-page HTML, request optional text and markdown outputs, and handle inline objects in cloro API responses for LLM analysis.

• MCP server: give any agent cloro's monitoring tools: Connect Claude, Cursor, or any MCP client to cloro's hosted MCP server and query ChatGPT, Perplexity, Gemini, Copilot, and Google Search as agent tools.

• Python SDK: Official cloro Python SDK reference: install, authenticate, and call Google Search, ChatGPT, Gemini, Perplexity, Copilot, Grok, and AI Mode.

• TypeScript SDK: Official cloro TypeScript and Node SDK reference: install, authenticate, and call Google Search, ChatGPT, Gemini, Perplexity, Copilot, Grok, and AI Mode.

• n8n integration — query AI engines from workflows: Install the n8n-nodes-cloro community node and query ChatGPT, Perplexity, Gemini, Copilot, Google AI Mode, Google Search, and Google News from any n8n workflow.

• Zapier integration — connect cloro to 8,000+ apps: Connect cloro to 8,000+ apps with Zapier — trigger AI-engine and Google Search checks from any Zap and send parsed results to Sheets, Slack, or your CRM.

• LangChain: Use the langchain-cloro Python package to give LangChain agents ready-made tools for Google Search, ChatGPT, Gemini, Perplexity, and Copilot.

• OpenClaw: Install the cloro plugin for OpenClaw and give your agent tools to monitor ChatGPT, Perplexity, Gemini, Copilot, Google AI Mode, Google Search, and Google News.

• API reference: Reference for the cloro API: base URL, authentication, response envelope, and monitoring endpoints for ChatGPT, Gemini, Copilot, Perplexity, and Google.

• Extract ChatGPT: Extract structured data from ChatGPT — answer text, cited sources, shopping cards, brand entities, and ads — for any prompt across supported regions.

• ChatGPT sources schema: Schema for source citations extracted from ChatGPT responses, including URLs, titles, snippets, publication dates, and footnote indicators.

• ChatGPT shopping cards schema: Schema for structured shopping cards extracted from ChatGPT responses, including product titles, pricing, ratings, merchant offers, and commercial details.

• ChatGPT inline products schema: Individual product references with detailed rationale, themed reviews, and rendering hints for inline display in ChatGPT responses.

• ChatGPT entities schema: Schema for structured entity data extracted from ChatGPT responses, including products, brands, organizations, people, and concepts with descriptions.

• ChatGPT map entries schema: Business and place information extracted from ChatGPT responses, including ratings, reviews, contact details, and location data from Yelp and Google.

• ChatGPT citation pills schema: Schema for inline citation pills returned by the ChatGPT endpoint, with each cited source attached to the visible pill chip it appears on in the answer.

• ChatGPT sponsored ads schema: Schema for sponsored ad blocks extracted from ChatGPT responses, including advertiser branding, product carousel cards, pricing, and offer metadata.

• Extract Google Search: Extract structured data from Google Search including organic results, People Also Ask, related searches, and optional AI Overview.

• Resolve a Google redirect link: Read Google's /goto redirect beside the destination with redirectLink, and resolve a redirect to its destination URL.

• Google organic search results schema: Schema for organic search results returned by the Google Search endpoint, including page title, URL, snippet, position, sitelinks, and rich enrichments.

• Google Search sponsored ads schema: Schema for sponsored ad results returned by the Google Search endpoint, including text ads and shopping-style cards from top-of-page and side carousels.

• Google Search shopping cards schema: Shopping product information returned by the Google Search endpoint when 'Popular products' or 'More products' panels appear on the SERP.

• Google Search product results schema: Schema for merchant offers parsed from the Google Search right-rail product panel: direct URLs, prices, installments, stock, and delivery badges.

• Google People Also Ask schema: Schema for People Also Ask questions returned by the Google Search endpoint, including expanded answers, source links, and optional AI Overview hydration.

• Google People Are Saying schema: Schema for cards from Google's 'What people are saying' SERP module returned by the Google Search endpoint, including source URLs, snippets, and themes.

• Google Local Pack schema: Schema for Google's local pack (map-backed 3-pack) returned by the Google Search endpoint, including ratings, category, address, phone, and hours.

• Google related searches schema: Schema for related search suggestions returned by the Google Search endpoint, including query text and links that surface related user intent on the SERP.

• Google AI Overview schema: AI Overview data returned by the Google Search endpoint, including text, markdown, sources, citation pills, related links, videos, and sponsored ads.

• Google Knowledge Graph schema: Schema for the Knowledge Graph panel returned by the Google Search endpoint: entity details, attributes, ratings, profiles, and panel-specific fields.

• Extract Perplexity: Extract structured data from Perplexity AI about your brand, products, or any topic across various regions.

• Perplexity sources schema: Schema for source citations returned by the Perplexity endpoint, listing URLs, titles, snippets, and publishers referenced throughout the generated answer.

• Perplexity citation pills schema: Schema for inline citation pills returned by the Perplexity endpoint, with each cited source attached to the visible pill chip it appears on in the answer.

• Perplexity shopping cards schema: Schema for shopping product cards returned by the Perplexity endpoint when shopping intent is detected, including titles, prices, ratings, and merchant links.

• Perplexity media results schema: Schema for videos and images returned by the Perplexity endpoint when media is relevant to the query, including thumbnails, source URLs, and captions.

• Perplexity travel and places schema: Schema for hotel listings and place cards returned by the Perplexity endpoint when travel intent is detected, including pricing, ratings, and amenities.

• Extract Microsoft Copilot: Extract structured data from Microsoft Copilot about your brand, products, or any topic across various regions.

• Microsoft Copilot sources schema: Schema for source citations returned by the Microsoft Copilot endpoint, listing URLs, titles, snippets, and publishers referenced in the generated answer.

• Microsoft Copilot citation pills schema: Schema for inline citation pills returned by the Microsoft Copilot endpoint, with each cited source attached to the visible pill chip it appears on.

• Microsoft Copilot shopping cards schema: Schema for shopping product cards returned by the Microsoft Copilot endpoint, including product titles, pricing, ratings, merchant offers, and image URLs.

• Microsoft Copilot map entries schema: Schema for business and place entries returned by the Microsoft Copilot endpoint, including names, ratings, reviews, photos, contact details, and addresses.

• Extract Google AI Mode: Extract structured data from AI Mode about your brand, products, or any topic across various regions.

• Google AI Mode sources schema: Schema for source citations returned by the Google AI Mode endpoint, listing URLs, titles, snippets, and publishers referenced in the generated answer.

• Google AI Mode citation pills schema: Schema for inline citation pills returned by the Google AI Mode endpoint, with each cited source attached to the visible pill chip it appears on.

• Google AI Mode places schema: Schema for inline place cards returned by the Google AI Mode endpoint when location intent is detected, including business names, ratings, and addresses.

• Google AI Mode shopping cards schema: Schema for shopping product cards returned by the Google AI Mode endpoint when shopping intent is detected, with pricing, ratings, offers, and reviews.

• Google AI Mode product results schema: Schema for expanded merchant offers behind each Google AI Mode product cluster: direct URLs, prices, installments, stock, and delivery badges.

• Google AI Mode ads schema: Schema for sponsored ad blocks returned by the Google AI Mode endpoint, including merchant branding, product carousel cards, pricing, and ad metadata.

• Google AI Mode inline products schema: Schema for individual product references embedded inline in the Google AI Mode response text, including titles, prices, merchants, and offer links.

• Google AI Mode videos schema: Schema for inline video cards embedded within the Google AI Mode response, including titles, thumbnails, durations, channels, and source links.

• Google AI Mode map schema: Schema for GPS-enriched location data returned by the Google AI Mode endpoint when map-aware results are surfaced, including coordinates, names, and addresses.

• Extract Grok: Extract structured data from Grok — answer text and cited sources, including X/Twitter references — for any prompt across supported regions.

• Grok sources schema: Schema for source citations returned by the Grok endpoint, enriched with preview text, creator details, site information, image URLs, and publication dates.

• Extract Google Gemini: Extract structured data from Google Gemini — generated answer text and cited sources for any prompt, with Markdown and HTML export formats.

• Google Gemini sources schema: Schema for source citations returned by the Google Gemini endpoint, including URLs, titles, snippets, and contextual descriptions for each reference.

• Google Gemini citation pills schema: Inline citation pills returned by the Gemini endpoint, with each cited source carried as a self-contained entry alongside the visible pill chip it came from.

• Google Gemini places schema: Schema for place cards returned by the Google Gemini endpoint when a lodging or local carousel appears, with names, ratings, prices, and links.

• Extract Google News: Extract structured news articles from Google News including titles, links, snippets, sources, dates, and thumbnails.

• Google News articles schema: Schema for structured news articles returned by the Google News endpoint, including titles, links, snippets, sources, publication dates, and thumbnails.

• List of countries: Returns a list of all supported ISO 3166-1 alpha-2 country codes. Can be filtered by model to get countries available for specific AI providers.

• List of states: Returns a list of US states supported for state-level geo-targeting. Only US is currently supported — other country values return an empty array.

• Get credit balance: Read your organization's credit balance and billing cycle programmatically, so async-only workloads can alert or pause before the balance runs out.

• Create async task: Submit an asynchronous task for background processing. Returns a task ID that you can use to poll for results or receive via webhook.

• Get task status: Poll the status and result of an asynchronous task by ID. Returns the task state and, once complete, the full structured result payload.

• Create batch tasks: Submit up to 500 async tasks in one request. Each task is validated independently, so one invalid task does not block the rest. Returns per-task results.

• Get async status: Get organization-wide async queue metrics including queued and processing task counts, and concurrency usage.

• Clear queue: Delete every QUEUED async task for your organization in one call. Tasks already processing keep running, and completed or failed history stays in place.

• Changelog: Stay up to date with the latest cloro API product updates, new features, enhancements, bug fixes, and announcements about our monitoring endpoints.