# Tools (/docs/api/gateway/tools)

Verified web search and safe page fetching, the same tools every codai agent uses.

Both endpoints go through the rules gate and the per-key rate limit. `search` returns only snippets verified against the fetched page, with domain (`include_domains` / `exclude_domains`), publish-date (`published_after` / `published_before`) and `freshness` filters; each result carries `published_at` (null when unknown, never the crawl date) and `crawled_at`. `fetch` enforces SSRF checks on every redirect hop and a 3 MB cap, and returns up to 40,000 characters (8,000 by default). Metered per call: $3 / 1,000 fast searches, $8 / 1,000 deep, $0.50 / 1,000 fetches; the first 1,000 calls a month are free and calls inside a codai agent turn are never charged. For multi-step questions use [deep research](./research.mdx). Details: [tools guide](../../agents/tools.mdx).

<OpenAPIPage document="./openapi/en/gateway.yaml" operations={[{path: '/v1/tools/search',method: 'post'},{path: '/v1/tools/fetch',method: 'post'}]} />