Ask the real Grok assistant and receive structured JSON with the answer, citations, X post references, follow-ups, and conversation history. No xAI developer key required.
{
"answer": "The capital of Lithuania is Vilnius.",
"conversation_id": "2121360458318016619",
"model": "grok-3-latest",
"mode": "fast",
"citations": [],
"search_results": [],
"x_search_results": [],
"web_search_triggered": false,
"truncated": false,
"elapsed_ms": 3390
}Every endpoint returns structured JSON. Failed upstream calls are not billed.
No. It returns the real consumer Grok assistant response, including the web citations and X post references shown by the product. You only need a ScrapeBadger API key.
Yes. Pass the returned conversation_id to /v1/grok/ask to add a follow-up, or fetch /v1/grok/conversations/{conversation_id} for the normalized message history.
web_search=auto lets Grok decide, force requests web and X search, and off disables those tools. mode selects auto, fast, or expert answering.
Simple answers can return in seconds. Grounded answers with web and X research take longer, so use a timeout of at least 90 seconds.