Skip to main content
POST
/
v1
/
monitor
/
grok
Monitor Grok Responses
curl --request POST \
  --url https://api.cloro.cloud/v1/monitor/grok \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "What are the best laptops for programming?",
  "country": "US",
  "include": {
    "markdown": false,
    "html": false,
    "rawResponse": false
  }
}
'
{
  "success": true,
  "result": {
    "text": "Based on current information and real-time web search, here are excellent laptop options for programming...",
    "html": "https://storage.cloro.cloud/results/c45a5081-808d-4ed3-9c86-e4baf16c8ab8/page-1.html",
    "sources": [
      {
        "position": 1,
        "url": "https://techcrunch.com/programming-laptops",
        "label": "TechCrunch",
        "description": "Best laptops for coding and development",
        "preview": "When looking for a programming laptop, prioritize RAM and processor power...",
        "searchEngineText": "Top Development Laptops 2025",
        "siteName": "TechCrunch",
        "metadataTitle": "Ultimate Guide to Programming Laptops",
        "creator": "Tech Team",
        "image": "https://techcrunch.com/preview.jpg",
        "favicon": "https://techcrunch.com/favicon.ico"
      }
    ],
    "searchQueries": [
      "best laptops for programming 2026",
      "top developer laptops 2026"
    ],
    "model": "grok-4-auto",
    "markdown": "Based on current information and real-time web search, here are excellent laptop options for programming..."
  }
}

​
Overview

The Grok endpoint extracts structured data from Grok with real-time web sources with enhanced metadata. Unlike other AI search providers, Grok provides extra contextual information for each source including preview text, creator details, site information, and image URLs.
Web search enabledThis endpoint uses Grok’s default interface, which always performs web searches for all requests to provide real-time information with source citations.

​
Request parameters

Uses common parameters. Endpoint-specific options:
  • include.rawResponse (boolean): Include raw streaming response events. Defaults to false

​
Response objects

The response includes the following sections. See each subpage for the full schema.
SectionDescription
SourcesSources with preview text, creator details, site information, and image URLs

​
Response schema

Includes common response fields plus:
FieldTypeDescription
result.textstringGrok’s response text
result.htmlstringResponse formatted in HTML (included when include.html is true)
result.sourcesarrayArray of web sources with enhanced metadata
result.searchQueriesstring[]Array of search queries Grok used to gather information
result.modelstringThe model identifier used to generate the response (e.g., “grok-4-auto”)
result.markdownstringResponse formatted in Markdown (included when include.markdown is true)
result.rawResponsearrayArray of Grok’s streamed response events (included when include.rawResponse is true)

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 Grok responses

​
prompt
string
required

The prompt to send to Grok

Required string length: 1 - 10000
Example:

"What are the best laptops for programming?"

​
country
string
required

Country/region code for localized response

Example:

"US"

​
include
object

Optional flags for including additional response formats

Response

successful Grok monitoring response

​
success
boolean
required
Example:

true

​
result
object
required

Grok response data