Skip to main content
POST
/
v1
/
monitor
/
gemini
Monitor Gemini Responses
curl --request POST \
  --url https://api.cloro.dev/v1/monitor/gemini \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Explain quantum computing",
  "country": "US",
  "include": {
    "markdown": true,
    "html": false
  }
}
'
{
  "success": true,
  "result": {
    "text": "Quantum computing is a type of computation...",
    "markdown": "**Quantum computing** is a type of computation...",
    "html": "<p><b>Quantum computing</b> is a type of computation...</p>",
    "sources": [
      {
        "position": 1,
        "label": "Wikipedia - Quantum Computing",
        "url": "https://en.wikipedia.org/wiki/Quantum_computing",
        "description": "Quantum computing is a multidisciplinary field...",
        "confidence_level": 95
      }
    ]
  }
}

​
Overview

The Google Gemini endpoint extracts structured data from Google’s Gemini AI. It captures the generated text response, citations/sources with confidence levels, and supports multiple export formats including Markdown and HTML.
Gemini is currently not available in European countries (EEA/EU). Requests specifying European countries will fail.

​
Request parameters

Uses common parameters.

​
Response schema

Includes common response fields plus:
FieldTypeDescription
result.textstringThe main text content of the response
result.sourcesarrayArray of sources cited in the response
result.markdownstringResponse formatted in Markdown (included when include.markdown is true)
result.htmlstringResponse formatted in HTML (included when include.html is true)

​
Source object structure

Gemini responses often include citations which are extracted into the sources array:
FieldTypeDescription
positionintegerIndex/position of the source
labelstringDisplay label or title
urlstringSource URL
descriptionstringContextual snippet or description
confidence_levelintegerConfidence score for the source (e.g., 0-100)
About sources availabilityGemini may not return sources for certain prompts. The sources array will be empty when Gemini doesn’t provide citations. This is normal behavior and doesn’t indicate an error - some prompts simply don’t trigger Gemini’s source-citing mechanism.

​
Example usage

{
  "prompt": "Explain quantum entanglement",
  "country": "US",
  "include": {
    "markdown": true
  }
}
Response: 
{
  "success": true,
  "result": {
    "text": "Quantum entanglement is a physical phenomenon...",
    "markdown": "**Quantum entanglement** is a physical phenomenon...",
    "sources": [
      {
        "position": 1,
        "label": "Wikipedia",
        "url": "https://en.wikipedia.org/wiki/Quantum_entanglement",
        "description": "Quantum entanglement is a physical phenomenon that occurs...",
        "confidence_level": 0.95
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request parameters for monitoring Gemini responses

​
prompt
string
required

The prompt to send to Gemini

Required string length: 1 - 10000
Example:

"Explain quantum computing"

​
country
string
default:US

Optional country/region code for localized monitoring

Example:

"US"

​
include
object

Optional flags for including additional response formats

Example:
{ "markdown": true, "html": false }

Response

successful Gemini monitoring response

​
success
boolean
required
Example:

true

​
result
object
required

Gemini response data