Skip to main content
POST
Monitor Grok Responses
Grok is temporarily unavailableGrok has blocked anonymous access for the time being. Requests to this endpoint will fail.

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.

Response schema

Includes common response fields plus:

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

state
string

State code for sub-country geo-targeting (e.g., "CA"). Only valid with country "US".

Required string length: 2
Pattern: ^[A-Z]{2}$
Example:

"CA"

Response

successful Grok monitoring response

success
boolean
required
Example:

true

result
object
required

Grok response data