# cloro

## Docs

- [Ads](https://cloro.dev/docs/api-reference/endpoint/aimode/ads.md): Schema for sponsored ad blocks returned by the Google AI Mode endpoint, including merchant branding, product carousel cards, pricing, and ad metadata.
- [Citation pills](https://cloro.dev/docs/api-reference/endpoint/aimode/citation-pills.md): 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.
- [Inline products](https://cloro.dev/docs/api-reference/endpoint/aimode/inline-products.md): Schema for individual product references embedded inline in the Google AI Mode response text, including titles, prices, merchants, and offer links.
- [Map](https://cloro.dev/docs/api-reference/endpoint/aimode/map.md): Schema for GPS-enriched location data returned by the Google AI Mode endpoint when map-aware results are surfaced, including coordinates, names, and addresses.
- [Places](https://cloro.dev/docs/api-reference/endpoint/aimode/places.md): Schema for inline place cards returned by the Google AI Mode endpoint when location intent is detected, including business names, ratings, and addresses.
- [Shopping cards](https://cloro.dev/docs/api-reference/endpoint/aimode/shopping-cards.md): Schema for shopping product cards returned by the Google AI Mode endpoint when shopping intent is detected, with pricing, ratings, offers, and reviews.
- [Sources](https://cloro.dev/docs/api-reference/endpoint/aimode/sources.md): Schema for source citations returned by the Google AI Mode endpoint, listing URLs, titles, snippets, and publishers referenced in the generated answer.
- [Videos](https://cloro.dev/docs/api-reference/endpoint/aimode/videos.md): Schema for inline video cards embedded within the Google AI Mode response, including titles, thumbnails, durations, channels, and source links.
- [Ads](https://cloro.dev/docs/api-reference/endpoint/chatgpt/ads.md): Schema for sponsored ad blocks extracted from ChatGPT responses, including advertiser branding, product carousel cards, pricing, and offer metadata.
- [Citation pills](https://cloro.dev/docs/api-reference/endpoint/chatgpt/citation-pills.md): 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.
- [Entities](https://cloro.dev/docs/api-reference/endpoint/chatgpt/entities.md): Schema for structured entity data extracted from ChatGPT responses, including products, brands, organizations, people, and concepts with descriptions.
- [Inline products](https://cloro.dev/docs/api-reference/endpoint/chatgpt/inline-products.md): Individual product references with detailed rationale, themed reviews, and rendering hints for inline display in ChatGPT responses.
- [Map entries](https://cloro.dev/docs/api-reference/endpoint/chatgpt/map.md): Business and place information extracted from ChatGPT responses, including ratings, reviews, contact details, and location data from Yelp and Google.
- [Shopping cards](https://cloro.dev/docs/api-reference/endpoint/chatgpt/shopping-cards.md): Schema for structured shopping cards extracted from ChatGPT responses, including product titles, pricing, ratings, merchant offers, and commercial details.
- [Sources](https://cloro.dev/docs/api-reference/endpoint/chatgpt/sources.md): Schema for source citations extracted from ChatGPT responses, including URLs, titles, snippets, publication dates, and footnote indicators.
- [Citation pills](https://cloro.dev/docs/api-reference/endpoint/copilot/citation-pills.md): Schema for inline citation pills returned by the Microsoft Copilot endpoint, with each cited source attached to the visible pill chip it appears on.
- [Map entries](https://cloro.dev/docs/api-reference/endpoint/copilot/map-entries.md): Schema for business and place entries returned by the Microsoft Copilot endpoint, including names, ratings, reviews, photos, contact details, and addresses.
- [Shopping cards](https://cloro.dev/docs/api-reference/endpoint/copilot/shopping-cards.md): Schema for shopping product cards returned by the Microsoft Copilot endpoint, including product titles, pricing, ratings, merchant offers, and image URLs.
- [Sources](https://cloro.dev/docs/api-reference/endpoint/copilot/sources.md): Schema for source citations returned by the Microsoft Copilot endpoint, listing URLs, titles, snippets, and publishers referenced in the generated answer.
- [List of countries](https://cloro.dev/docs/api-reference/endpoint/countries.md): 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.
- [Create async task](https://cloro.dev/docs/api-reference/endpoint/create-async-task.md): Submit an asynchronous task for background processing. Returns a task ID that you can use to poll for results or receive via webhook.
- [Create batch tasks](https://cloro.dev/docs/api-reference/endpoint/create-batch-tasks.md): Submit up to 500 async tasks in a single request. Each task is validated independently — one invalid task does not block others. Returns per-task results with success or failure details.
- [Citation pills](https://cloro.dev/docs/api-reference/endpoint/gemini/citation-pills.md): 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.
- [Sources](https://cloro.dev/docs/api-reference/endpoint/gemini/sources.md): Schema for source citations returned by the Google Gemini endpoint, including URLs, titles, snippets, and contextual descriptions for each reference.
- [Get async status](https://cloro.dev/docs/api-reference/endpoint/get-async-status.md): Get organization-wide async queue metrics including queued and processing task counts, and concurrency usage.
- [Get task status](https://cloro.dev/docs/api-reference/endpoint/get-task-status.md): Fetch the status and result of an asynchronous task.
- [News articles](https://cloro.dev/docs/api-reference/endpoint/google-news/news-articles.md): Schema for structured news articles returned by the Google News endpoint, including titles, links, snippets, sources, publication dates, and thumbnails.
- [AI Overview](https://cloro.dev/docs/api-reference/endpoint/google/ai-overview.md): AI Overview data returned by the Google Search endpoint, including text, markdown, sources, citation pills, videos, and sponsored ads.
- [Knowledge Graph](https://cloro.dev/docs/api-reference/endpoint/google/knowledge-graph.md): Schema for the Knowledge Graph panel returned by the Google Search endpoint, including entity details, attributes, ratings, profiles, and panel-type-specific fields.
- [Organic results](https://cloro.dev/docs/api-reference/endpoint/google/organic-results.md): Schema for organic search results returned by the Google Search endpoint, including page title, URL, snippet, position, sitelinks, and rich enrichments.
- [People Also Ask](https://cloro.dev/docs/api-reference/endpoint/google/people-also-ask.md): Schema for People Also Ask questions returned by the Google Search endpoint, including expanded answers, source links, and optional AI Overview hydration.
- [People Are Saying](https://cloro.dev/docs/api-reference/endpoint/google/people-are-saying.md): Schema for cards from Google's 'What people are saying' SERP module returned by the Google Search endpoint, including source URLs, snippets, and themes.
- [Related searches](https://cloro.dev/docs/api-reference/endpoint/google/related-searches.md): Schema for related search suggestions returned by the Google Search endpoint, including query text and links that surface related user intent on the SERP.
- [Shopping cards](https://cloro.dev/docs/api-reference/endpoint/google/shopping-cards.md): Shopping product information returned by the Google Search endpoint when 'Popular products' or 'More products' panels appear on the SERP.
- [Sponsored ads](https://cloro.dev/docs/api-reference/endpoint/google/sponsored-ads.md): 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.
- [Sources](https://cloro.dev/docs/api-reference/endpoint/grok/sources.md): Schema for source citations returned by the Grok endpoint, enriched with preview text, creator details, site information, image URLs, and publication dates.
- [Extract Google AI Mode](https://cloro.dev/docs/api-reference/endpoint/monitor-aimode.md): Extract structured data from AI Mode about your brand, products, or any topic across various regions
- [Extract ChatGPT](https://cloro.dev/docs/api-reference/endpoint/monitor-chatgpt.md): Extract structured data from ChatGPT about your any topic
- [Extract Microsoft Copilot](https://cloro.dev/docs/api-reference/endpoint/monitor-copilot.md): Extract structured data from Microsoft Copilot about your brand, products, or any topic across various regions
- [Extract Google Gemini](https://cloro.dev/docs/api-reference/endpoint/monitor-gemini.md): Extract structured data from Google Gemini about your brand, products, or any topic
- [Extract Google Search](https://cloro.dev/docs/api-reference/endpoint/monitor-google.md): Extract structured data from Google Search including organic results, People Also Ask, related searches, and optional AI Overview
- [Extract Google News](https://cloro.dev/docs/api-reference/endpoint/monitor-google-news.md): Extract structured news articles from Google News including titles, links, snippets, sources, dates, and thumbnails
- [Extract Grok](https://cloro.dev/docs/api-reference/endpoint/monitor-grok.md): Extract structured data from Grok about your brand, products, or any topic across various regions
- [Extract Perplexity](https://cloro.dev/docs/api-reference/endpoint/monitor-perplexity.md): Extract structured data from Perplexity AI about your brand, products, or any topic across various regions
- [Citation pills](https://cloro.dev/docs/api-reference/endpoint/perplexity/citation-pills.md): 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.
- [Media](https://cloro.dev/docs/api-reference/endpoint/perplexity/media.md): Schema for videos and images returned by the Perplexity endpoint when media is relevant to the query, including thumbnails, source URLs, and captions.
- [Shopping cards](https://cloro.dev/docs/api-reference/endpoint/perplexity/shopping-cards.md): Schema for shopping product cards returned by the Perplexity endpoint when shopping intent is detected, including titles, prices, ratings, and merchant links.
- [Sources](https://cloro.dev/docs/api-reference/endpoint/perplexity/sources.md): Schema for source citations returned by the Perplexity endpoint, listing URLs, titles, snippets, and publishers referenced throughout the generated answer.
- [Travel and places](https://cloro.dev/docs/api-reference/endpoint/perplexity/travel-and-places.md): Schema for hotel listings and place cards returned by the Perplexity endpoint when travel intent is detected, including pricing, ratings, and amenities.
- [List of states](https://cloro.dev/docs/api-reference/endpoint/states.md): Returns a list of US states supported for state-level geo-targeting. Only US is currently supported — other country values return an empty array.
- [Changelog](https://cloro.dev/docs/changelog.md): Stay up to date with the latest cloro API product updates, new features, enhancements, bug fixes, and announcements about our monitoring endpoints.
- [Authentication](https://cloro.dev/docs/guides/authentication.md): Learn how to authenticate with the cloro API using Bearer tokens, manage API keys securely, and handle authentication errors in your requests.
- [Billing](https://cloro.dev/docs/guides/billing.md): Subscription plans, payment cycles, standard vs. enterprise plans, credit expiration, overage policies, and account management for cloro API.
- [Concurrency](https://cloro.dev/docs/guides/concurrency.md): Learn how to process multiple requests efficiently with the cloro API using async patterns, webhooks, and concurrent workers for optimal throughput.
- [Credits & limits](https://cloro.dev/docs/guides/credits-and-limits.md): Understanding API credits, pricing, rate limits, concurrency, and usage monitoring for all cloro monitoring endpoints and request management.
- [Error handling](https://cloro.dev/docs/guides/error-handling.md): Understanding API errors, HTTP status codes, error response formats, retry logic, and troubleshooting strategies for all cloro monitoring endpoints.
- [Making requests](https://cloro.dev/docs/guides/making-requests.md): Compare the two cloro request modes — synchronous and asynchronous — including credit cost, latency, concurrency limits, and guidance on which mode to use.
- [Asynchronous requests](https://cloro.dev/docs/guides/making-requests/async.md): Submit async tasks to the cloro API: two-step submit-and-fetch flow, webhooks vs polling, task states, prioritization, queue limits, and concurrency.
- [Synchronous requests](https://cloro.dev/docs/guides/making-requests/sync.md): Make synchronous requests to the cloro API: request structure, common parameters, response shape, optional formats, and code examples.
- [Output formats](https://cloro.dev/docs/guides/output-formats.md): 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.
- [Providers](https://cloro.dev/docs/guides/providers.md): Compare cloro provider support across ChatGPT, Gemini, Copilot, Perplexity, Grok, Google AI Mode, and Google Search, including features and credit costs.
- [Regional availability](https://cloro.dev/docs/guides/regional-availability.md): Verify that a country proxy was applied to your request, distinguish routing failures from model bias, and understand how language interacts with targeting.
- [Webhooks](https://cloro.dev/docs/guides/webhooks.md): Receive async task results via webhooks: payload shape, retry behavior, HMAC signature verification in Node.js, Python, and Go, and troubleshooting tips.
- [Welcome to cloro](https://cloro.dev/docs/index.md): Extract structured data from ChatGPT, Perplexity, Microsoft Copilot, Google AI Mode, Google Search with AI Overview and other AI models
- [Quickstart](https://cloro.dev/docs/introduction/quickstart.md): 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.

## OpenAPI Specs

- [openapi](https://cloro.dev/docs/api-reference/openapi.json)