Cloro integration

Extract AI Answer

Synchronously extract a Gemini or Perplexity answer for a prompt and country. This spends credits and includes Cloro's 2-credit synchronous surcharge. Use Submit Async Task for ChatGPT or Copilot, which can exceed the synchronous execution deadline.

Extract Google AI Mode Answer

Extract a structured Google AI Mode answer with sources and optional rich modules for a prompt and country. This synchronous call costs at least 6 credits.

Get Async Queue Status

Read organization-wide queued and processing counts, priority distribution, and current async concurrency without modifying the queue.

Get Async Task

Get a queued Cloro task by ID, or wait with bounded polling until it reaches COMPLETED or FAILED. FAILED is returned as a valid terminal record with its provider response details intact.

Get Credits

Read the organization's current completed-charge credit balance and billing cycle. Queued async work is not reserved, and even after a task reports a completed charge, the balance may take about 25 seconds to reflect it.

List Supported Countries

Return Cloro's current supported country codes, optionally filtered by provider model. This reports geographic support only and does not confirm that a provider monitor is operational.

List US States

Return the US state and DC codes accepted for state-level targeting. State targeting applies only to ChatGPT, Gemini, Copilot, and Perplexity and adds 2 credits.

Search Google

Extract structured Google web or Google News results from a query and country, or web results from a complete Google Search URL. This synchronous call costs at least 5 credits; extra result pages cost 2 credits each.

Submit Async Task

Queue one non-cancelable Cloro monitor task and return its task ID and estimated credit charge without waiting. An accepted task continues after this call and spends the reported credits on completion. Use Get Async Task to retrieve it.

Submit Async Task Batch

Queue 1-500 independently validated, non-cancelable Cloro monitor tasks. Each accepted task continues after this call and spends its reported credits on completion. Inspect summary, partial_success, and every indexed result because one response can contain both accepted and rejected items.