# Grok X Search

> Grok X Search is a paid API for AI agents from Grok at grok.mpp.paywithlocus.com, paid per call via MPP, Dynamic (~$0.01–$0.50) (dynamic), status unknown (last checked 2026-10-11).

Chat with the Grok-4 model augmented by real-time X (Twitter) search to answer questions using live posts and discussions

## Facts

- Endpoint: POST https://grok.mpp.paywithlocus.com/grok/x-search?utm_source=zero.xyz
- Price: Dynamic (~$0.01–$0.50) (dynamic)
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 2
- Provider: Grok
- Docs: https://docs.x.ai
- Website: https://x.ai
- Tags: llm, chat, x-search, web-search, image-generation, tts, ai
- Canonical page: https://www.zero.xyz/c/grok-x-search-acf39a93
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j_TssRXknnERPtdnZPHWI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability grok-x-search-acf39a93 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Generate text with current Grok models grounded in live X (Twitter) search results. Uses the xAI Responses API with X search.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/grok-x-search-acf39a93/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from grok.mpp.paywithlocus.com](https://www.zero.xyz/host/grok.mpp.paywithlocus.com/llms.txt)