{"uid":"cap_j_TssRXknnERPtdnZPHWI","slug":"grok-x-search-acf39a93","name":"Grok X Search","description":"Generate text with current Grok models grounded in live X (Twitter) search results. Uses the xAI Responses API with X search.","url":"https://grok.mpp.paywithlocus.com/grok/x-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["model","messages","max_tokens","max_tool_calls"],"properties":{"model":{"type":"string","description":"Metered x402 model ID: 'grok-4.6', 'grok-4.5', 'grok-4.5-latest', 'grok-4.3', 'grok-4.20-0309-reasoning', or 'grok-4.20-0309-non-reasoning'. Multi-agent is excluded because xAI does not support an output-token cap for it."},"messages":{"type":"array","items":{"type":"object","required":["role"],"properties":{"name":{"type":"string"},"role":{"type":"string"},"content":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"object","required":["type"],"properties":{"text":{"type":"string"},"type":{"type":"string"},"image_url":{"type":"object","required":["url"],"properties":{"url":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}},{"type":"null"}]},"tool_calls":{"type":"array","items":{"type":"object","additionalProperties":true}},"tool_call_id":{"type":"string"}},"additionalProperties":true},"description":"Conversation messages. Each: { role: \"system\"|\"user\"|\"assistant\", content: \"text\" }"},"max_turns":{"type":"number","description":"Maximum agentic tool turns (1–10, default 3). Each turn may run several server tool calls in parallel. Enforced upstream and priced into the quote per turn."},"max_tokens":{"type":"number","description":"Maximum output tokens per model turn. Required for metered x402."},"temperature":{"type":"number","description":"Sampling temperature (0.0–2.0, default 1.0)"},"max_tool_calls":{"type":"number","description":"Required for metered x402 (1–10). Sets the metered spend bound and is applied upstream as the max_turns cap; when both are sent the lower value wins."}},"additionalProperties":true},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["llm","chat","x-search","web-search","image-generation","tts","ai"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":true,"priceHint":"Dynamic (~$0.01–$0.50)","priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"dynamic","summary":"Dynamic (~$0.01–$0.50) (dynamic)","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__7yHOnkwRbe0DzvuIt_Zu","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"Grok","brandSlug":"grok","brandBaseUrl":"https://x.ai","brandDocsUrl":"https://docs.x.ai","whatItDoes":"Chat with the Grok-4 model augmented by real-time X (Twitter) search to answer questions using live posts and discussions","exampleAgentPrompt":"Search X using Grok-4 and tell me what people are saying about the SpaceX Starship launch today — use the grok-4-0709 model and keep the response concise.","exampleUseCases":null,"resultDescription":"A text completion from the Grok-4 model that includes synthesized information drawn from real-time X (Twitter) posts, including relevant context, summaries of what users are saying, and potentially cited post content. Returned as a chat-completion-style message.","failureModes":["Invalid or unsupported model name (not a grok-4 family model) returns an error","Missing required 'messages' field causes a 400 validation error","Query topic has no recent X posts, resulting in a low-information response","Rate limiting or payment failure if USDC balance is insufficient","Temperature out of 0.0–2.0 range may cause a validation error","X search index may have a slight delay for very recent events"],"whenToPreferThis":"Choose this endpoint when you need real-time information from X (Twitter) posts — trending topics, social sentiment, breaking news reactions, or user opinions. Prefer over generic web search when the query is specifically about what people are posting on X. Use over the base Chat endpoint when you need live social data rather than the model's training knowledge.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-05-29T21:17:44.214Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:30:47.357Z","isFirstParty":false,"canonicalSlug":"grok-x-search-acf39a93"}