---
title: "Platform-default web search fallback"
method: POST
path: "/v1/tools/web-search"
tags: ["Agent Tools"]
---

# Platform-default web search fallback

`POST /v1/tools/web-search`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/tools/web-search`
- Auth: HTTP bearer

Called on the agent's own token (not a Shroud-internal callback). Used by the runtime `web_search` tool when an agent has no BRAVE_API_KEY/TAVILY_API_KEY/SERP_API_KEY/ONECLAW_WEB_SEARCH_BINDING of its own — proxies to a shared, platform-provided Brave Search key under a hard monthly platform-wide cap.

## Request body

- object
  - `query` string, required
  - `num_results` integer

## Response `200`

Search results

- WebSearchResponse
  - `results` WebSearchResult[], required
    - `title` string, required
    - `url` string, required
    - `snippet` string, required
  - `provider` string, required

## Other responses

- `400`: Invalid request
- `403`: Called on a non-agent token

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)