> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Web Search

The [Web Search](/docs/web-search) API as tools the model calls. Web Search is also available as a standalone product.

```bash theme={null}
telnyx-acp add tool web_search
telnyx-acp add tool web_search --domains acme.example,docs.acme.example --freshness week --research
```

```text theme={null}
✓ added tool web_search (web_search, fetch_page for the model) — applied on next deploy
✓ updated tool web_search (web_search, fetch_page, research for the model; results from acme.example, docs.acme.example) — applied on next deploy
```

The model's tools:

| Tool | Does |
| - | - |
| `web_search` | Searches the live web. Five results by default, up to ten on request, each with a title, the URL and a short excerpt, plus up to three news results. |
| `fetch_page` | Reads one page as Markdown, trimmed to 12,000 characters. `--no-contents` leaves it out. |
| `research` | A synthesized answer with citations, for a question that needs several sources. Slow, tens of seconds, so it is added only with `--research`. |

`--domains a,b` limits `web_search` results to bare hostnames, up to fifty, and `--freshness day|week|month|year` to recent pages; neither restricts `fetch_page` or `research`. The calls go through the account's own credential, so there is no key to add; `dev` uses the signed-in session the same way.

```json theme={null}
"tools": [{ "type": "web_search", "research": true, "domains": ["acme.example"], "freshness": "week" }]
```

## Remove

```bash theme={null}
telnyx-acp remove tool web_search
```