Skip to main content
GET
cURL
X (Twitter) posts includedEvery response includes 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, and EXPERT for 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

X-API-Key
string
header
required

Your ScrapeLLM API key passed in the request header.

Query Parameters

prompt
string
required

The prompt to send to Grok. Maximum 4,000 characters.

Required string length: 1 - 4000
country
string
default:US

ISO 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.

Required string length: 2
mode
enum<string>
default:MODEL_MODE_AUTO

Grok 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.
Available options:
MODEL_MODE_AUTO,
MODEL_MODE_FAST,
MODEL_MODE_EXPERT
bypass_cache
boolean
default:false

Skip the response cache and always fetch a fresh result.

timeout
number<float>
default:300

Maximum seconds to wait for Grok to respond. Must be between 10 and 600.

Required range: 10 <= x <= 600

Response

Scrape completed successfully.

scraper
string
required

Always "grok".

Example:

"grok"

status
string
required

"done" on success.

Example:

"done"

job_id
string
required

Unique identifier for this scrape job.

Example:

"job_abc123"

prompt
string
required

The prompt that was submitted.

Example:

"What brands do marketers recommend for email automation?"

country
string
required

The country the request was routed through.

Example:

"US"

mode
enum<string>
required

The Grok reasoning mode used for this request.

Available options:
MODEL_MODE_AUTO,
MODEL_MODE_FAST,
MODEL_MODE_EXPERT
Example:

"MODEL_MODE_AUTO"

result
string
required

Plain-text response from Grok.

Example:

"Marketers commonly recommend Mailchimp, HubSpot, and Klaviyo..."

credits_used
integer
required

Credits consumed by this request. Always 3 for Grok.

Example:

3

elapsed_ms
number<float>
required

Total end-to-end request duration in milliseconds.

Example:

7841.2

cached
boolean
required

true if this response was served from cache.

Example:

false

result_markdown
string | null

Markdown-formatted response from Grok.

Example:

"Marketers commonly recommend **Mailchimp**, **HubSpot**, and **Klaviyo**..."

web_sources
object[]

Web pages cited by Grok, each with a title, preview snippet, and URL.

x_results
object[]

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.

Example:
conversation
object | null

Metadata about the underlying Grok conversation session.

llm_model
string | null

Grok model variant used (e.g. grok-3).

Example:

"grok-3"

markdown_url
string | null

Hosted .md URL for this response. Expires after 24 hours.

Example:

"https://scrapellm.com/md/job_abc123.md"