# Grok Web Search Chat

> Grok Web Search Chat 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-10).

Chat with Grok-4 using real-time web search to ground responses in current information

## Facts

- Endpoint: POST https://grok.mpp.paywithlocus.com/grok/web-search?utm_source=zero.xyz
- Price: Dynamic (~$0.01–$0.50) (dynamic)
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- 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-web-search-30615ca5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y7lMFBSId10CVGNIurscL

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-web-search-30615ca5 -d '<json body>'
```

Example prompt: Using Grok-4 with web search enabled, what are the latest developments in fusion energy research as of this week? Only pull from .edu and .gov domains, and give me a thorough summary.

## When to prefer this

Choose this endpoint when you need an AI chat response grounded in current, real-time web information — especially for recent events, live data, or fact-checking tasks. Prefer this over standard Grok chat when recency matters and the model's training cutoff would be insufficient. Use the domain filter feature when you need answers sourced from specific trusted websites. Prefer X Search instead when the information you need lives primarily on X (Twitter).

## Known failure modes

- Missing required 'model' field returns validation error
- Model name not from grok-4 family may return unsupported model error
- Messages array empty or malformed returns bad request
- Exceeding domain filter limits (max 5 allowed/excluded domains) returns parameter error
- Invalid temperature value outside 0.0–2.0 range returns validation error
- Payment failure or insufficient USDC balance returns 402 error
- Rate limiting may return 429 if too many requests are made

## How this service works

Generate text with current Grok models grounded in live web search results. Uses the xAI Responses API with automatic web search.

## Output

A chat completion response from a Grok-4 model that includes an AI-generated answer grounded in real-time web search results. The response synthesizes retrieved web content into a coherent reply based on the conversation messages provided.

## 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."
  },
  "search_parameters": {
   "type": "object",
   "description": "Web search filters: { allowed_do
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/grok-web-search-30615ca5/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)