# Grok Web Search via Locus x402

> Grok Web Search via Locus x402 is a paid API for AI agents from grok.x402.paywithlocus.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Performs real-time web search using xAI's Grok models, returning AI-synthesized answers grounded in live web results, paid per-call via x402 micropayment.

## Facts

- Endpoint: POST https://grok.x402.paywithlocus.com/grok/web-search
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/grok-web-search-via-locus-x402-03492e65
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bS-3hWgnMCBBrq1PZIOTo

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-via-locus-x402-03492e65 -d '<json body>'
```

Example prompt: Search the web using Grok (grok-4.5) to find the latest information on quantum computing breakthroughs in 2025, limit to 500 output tokens and only search from nature.com and science.org.

## When to prefer this

Choose this endpoint when you need Grok AI to search the live web and synthesize an answer in real time, especially when you want domain-level control over which sources are searched (allowed/excluded domains). Prefer it over generic chat endpoints when freshness of information matters. It is particularly strong for questions about current events, recent publications, or time-sensitive facts. The x402 micropayment model at $0.001 USDC per call makes it cost-effective for high-frequency agent workflows that need grounded, up-to-date answers rather than relying solely on model training data.

## Known failure modes

- Insufficient x402 payment or payment failure — request rejected before processing
- Invalid model ID provided — endpoint only accepts metered model IDs, not multi-agent variants
- max_tokens not specified — required for metered x402, will error if missing
- max_tool_calls exceeds range of 1–10 — rejected with validation error
- Domain filter lists exceed 5 entries each — search_parameters ignored or rejected
- Rate limiting or xAI upstream unavailability — 5xx error propagated
- Malformed messages array — missing role or content fields cause parsing errors

## How this service works

xAI models — chat, web/X search, code execution, image generation/editing, and text-to-speech.

## Output

Returns a JSON object containing the AI-generated answer synthesized from live web search results, payment details (settled and authorized USDC amounts), a unique request ID, and a status URL for tracking the request. The data field contains the Grok model's response grounded in real-time web content.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "model": {
   "type": "string"
  },
  "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
   }
  },
  "max_turns": {
   "type": "number"
  },
  "max_tokens": {
   "type": "number"
  },
  "temperature": {
   "type": "number"
  },
  "max_tool_calls": {
   "type": "number"
  },
  "search_parameters": {
   "type": "object",
   "additionalProperties": true
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/grok-web-search-via-locus-x402-03492e65/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from grok.x402.paywithlocus.com](https://www.zero.xyz/host/grok.x402.paywithlocus.com/llms.txt)