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

# Web search

> Give models live access to the web.

Let a model search the web before answering. Two ways to enable it:

## Suffix (simplest)

Append `:online` to any chat model:

```json theme={null}
{ "model": "gpt-5.5:online", "messages": [...] }
```

## Plugin (configurable)

Pass a `plugins` array to control the number of results:

```json theme={null}
{
  "model": "gpt-5.5",
  "messages": [{"role": "user", "content": "What happened in AI this week?"}],
  "plugins": [{ "id": "web", "max_results": 5 }]
}
```

<Note>
  Web search adds a small extra cost per request, shown in your usage history.
</Note>