Skip to main content
POST
/
v1
/
monitor
/
grok
Monitor Grok Responses
curl --request POST \
  --url https://api.cloro.dev/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
  }
}
'
{
  "success": true,
  "result": {
    "text": "Based on current information and real-time web search, here are excellent laptop options for programming...",
    "html": "https://storage.cloro.dev/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"
      }
    ],
    "markdown": "Based on current information and real-time web search, here are excellent laptop options for programming..."
  }
}

​
Overview

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

​
Request parameters

Uses common parameters.

​
Response schema

Includes common response fields plus:

​
Core response fields

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.markdownstringResponse formatted in Markdown (included when include.markdown is true)

​
Enhanced source metadata

Grok provides comprehensive metadata for each source beyond basic link information:
FieldTypeDescription
positionnumberPosition order of the source in the response
urlstringDirect URL to the source content
labelstringSource name or publication
descriptionstringBrief description of what the source contains
previewstringText snippet preview from the source
searchEngineTextstringSearch engine display text for the source
siteNamestringWebsite name
metadataTitlestringSource page metadata title
creatorstringContent creator or author
imagestringURL to preview image from the source
faviconstringURL to website favicon

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
default:US

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