Grok
Extract structured data from the Grok web interface - web sources, real X posts, follow-up questions, and three reasoning modes - as clean JSON.
x_results - real posts from X that Grok pulled in to inform its answer. No other AI scraper surfaces this data.Overview
Use Grok to track brand sentiment on X, monitor real-time reactions to news, and understand what the X community is saying about any topic - all grounded in Grok’s AI-synthesised answer. The three reasoning modes let you trade off speed versus depth depending on your use case.Unique features
- X posts: Real posts from X (Twitter) that Grok cited - includes post text, author, view count, and timestamp
- Web sources: Standard web citations alongside the X posts
- Three reasoning modes:
AUTO,FAST, andEXPERTfor different speed/depth trade-offs - Related questions: Grok’s suggested follow-up questions
Modes
Example request
Response schema
Includes common response fields plus:Common questions
Which countries are not supported?
JP (Japan) and TW (Taiwan) are not currently supported. Requests with these country codes will return an error.When should I use MODEL_MODE_EXPERT?
For complex research questions where depth matters more than speed - competitor analysis, in-depth market research, or multi-faceted topics. Expert mode takes longer but produces more thorough answers.
Are X posts always present in the response?
No. X posts only appear when Grok determines they’re relevant to the query. Social-focused questions like “What are people saying about X?” are more likely to surface posts than technical or factual queries.Authorizations
Your ScrapeLLM API key passed in the request header.
Query Parameters
The prompt to send to Grok. Maximum 4,000 characters.
1 - 4000ISO 3166-1 alpha-2 country code. Routes the request through infrastructure in
that region for localised responses. JP and TW are not supported. Defaults to US.
2Grok reasoning mode:
MODEL_MODE_AUTO— Grok selects the model automatically (default).MODEL_MODE_FAST— Quick responses using Grok mini.MODEL_MODE_EXPERT— Deeper reasoning using the full Grok model.
MODEL_MODE_AUTO, MODEL_MODE_FAST, MODEL_MODE_EXPERT Skip the response cache and always fetch a fresh result.
Maximum seconds to wait for Grok to respond. Must be between 10 and 600.
10 <= x <= 600Response
Scrape completed successfully.
Always "grok".
"grok"
"done" on success.
"done"
Unique identifier for this scrape job.
"job_abc123"
The prompt that was submitted.
"What brands do marketers recommend for email automation?"
The country the request was routed through.
"US"
The Grok reasoning mode used for this request.
MODEL_MODE_AUTO, MODEL_MODE_FAST, MODEL_MODE_EXPERT "MODEL_MODE_AUTO"
Plain-text response from Grok.
"Marketers commonly recommend Mailchimp, HubSpot, and Klaviyo..."
Credits consumed by this request. Always 3 for Grok.
3
Total end-to-end request duration in milliseconds.
7841.2
true if this response was served from cache.
false
Markdown-formatted response from Grok.
"Marketers commonly recommend **Mailchimp**, **HubSpot**, and **Klaviyo**..."
Web pages cited by Grok, each with a title, preview snippet, and URL.
X (Twitter) posts surfaced by Grok's native X search integration. This is unique to Grok among all major LLMs.
Follow-up questions suggested by Grok.
Metadata about the underlying Grok conversation session.
Grok model variant used (e.g. grok-3).
"grok-3"
Hosted .md URL for this response. Expires after 24 hours.
"https://scrapellm.com/md/job_abc123.md"