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

# Web Search

> Real-time web search integration with the Responses API

The Responses API supports web search integration, allowing models to access real-time information from the internet and provide responses with proper citations and annotations.

> [!WARNING]
>
> **Deprecated Plugin Approach**
>
> The web search plugin (`plugins: [{ id: "web" }]`) shown below is deprecated. Use the [`openrouter:web_search` server tool](https://openrouter.ai/docs/guides/features/server-tools/web-search) instead, which works with both the Chat Completions and Responses APIs via the `tools` array.

## Web Search Plugin

Enable web search using the `plugins` parameter:

```typescript title="TypeScript" lines theme={null}
const response = await fetch('https://openrouter.ai/api/v1/responses', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/o3',
    input: 'What is OpenRouter?',
    plugins: [{ id: 'web', max_results: 3 }],
    max_output_tokens: 9000,
  }),
});

const result = await response.json();
console.log(result);
```

```python title="Python" lines theme={null}
import requests

response = requests.post(
    'https://openrouter.ai/api/v1/responses',
    headers={
        'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'model': 'openai/o3',
        'input': 'What is OpenRouter?',
        'plugins': [{'id': 'web', 'max_results': 3}],
        'max_output_tokens': 9000,
    }
)

result = response.json()
print(result)
```

```bash title="cURL" lines theme={null}
curl -X POST https://openrouter.ai/api/v1/responses \
  -H "Authorization: Bearer YOUR_OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/o3",
    "input": "What is OpenRouter?",
    "plugins": [{"id": "web", "max_results": 3}],
    "max_output_tokens": 9000
  }'
```

```go title="Go" lines theme={null}
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"model":             "openai/o3",
		"input":             "What is OpenRouter?",
		"plugins":           []map[string]any{{"id": "web", "max_results": 3}},
		"max_output_tokens": 9000,
	})

	req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	result, _ := io.ReadAll(resp.Body)
	fmt.Println(string(result))
}

```

```text title="Output" theme={null}
{
  id: "gen-1794947622-R1UKdLTSjFyYjQajS9Bm",
  object: "response",
  created_at: 1794947622,
  model: "openai/o3",
  status: "completed",
  completed_at: 1794947669,
  output: [
    {
      id: "rs_0d99c78179edda6f016afcba27385c87d1988c07dea5d818c3",
      type: "reasoning",
      status: "completed",
      summary: [Array ...],
      encrypted_content: "gAAAAABq_LopR38QmXbJBWfy2eNwXGqoi-G5qJY0hmuVz4R4jg45tgAZAjGQm-dReq6TWssUI1cg1Zrt1hQX9sN6bS330WT0U_b6tADJjpGtypEur4YdXnVvHKOikmC4C-6j5De0Ovki_BpkYaKqK-eihaQ18plHe7YONbZl7JJAVJQY5Pc4hycfKUCqXGDhku9Nn838xMIHFCm3U0-BVwqKY3OYmToP2uEB1OB1swz4eIYPKahmoWB-E0tg723x1kPnfVt5DQHsYkasDF3lyd6FH8d0M9vS-XyyDjlKv8dxZdXADviKnkOt5k0LoUi6flonsSedlN5fnyO_S8Sj6hYHYBWfnTtWCwRwLRe8epYWu_syxLDUAAGb5DyLTwpGvmBi74VgIhuo7IF3pUrOZ15E-VjzWKCQb1hM8ybIxLeNKz3zkZSP08aSk3s9BPLl7MMg9nSSpqd_Ac7WABVVFehxLLUE7hWeIDnrgbuijC--SsEop1pFDJBzPAZjql_D1fywyPFs_5MTLcUPmkg6NUq36mms-QxySFq2scscb2O1RRbW_7jfm1AgDluIo0pTzmSUYiyCnauFsY5H6K-RRRVsgrodoZBEMv-c2DKMjlXiDCklYTTDaPxVCxA3WOoFVl_qh4WEF05hsB9lqkf60nuAUhlH-FWXDiGv0686Djq1tBKV6M1NOovN81VjzvO6zKHXhu_uSPFxx34AXaavUaq3Cz31lkTCP96TbJSQxlQ8q1q6gBjKhE5jkoiZJ4M_9S5m5CP8-eERBk2f1zFXMd2oRvW_wAvyyyXif6IwuDMep8LH_ZrMGKy5NhR88JKZnJ0kSvvyUDqdIm-QiO3TeE75DrVl75zBAygaa8VF58uJiCRfZpB1KAV0nawnc_aXUFfnCRzgCKXF9KdRs2o5lDuM4oPFDWxY1xxn5pJVt05oMnh_XgH-aLjUCOeQe8dGCgmcZn9l3huWhoxsM6xR0npe6_dPpo6iT8EANgL4stiFlEDN0u0za0cFP_WrS4U58u6HBGYo2aZq-7U33jiSD2cpJqlDFf86mbPHk8uDWobkzsitB0WWeeSeR4b8sTTF9naoIIOhNFna7qaluhn3lmJkppnpyPe8Y_LRvB81L211USZOYUA_zAHQoz8dS4EUTboIyp1fjJ3GT-JLguFW_8RpvPo09tENEi7jv9DNMlMJFeapjfxXyJehSI7sjm0odhK889AkhEJ07IEtv4wAAO7yOrRiYlD8e7E4RTo0Z-Zl1R_NTJeLsmI9OsARXetmerHCgABm4Y9PEP6oKWOiP6x9MfYB3Zdn4gQ6wVuzWMxCJmmU9xI_prKM1uwMbyR4DRkqUsbzmiYgb2JodhmXbXnIUrsOH26mKi13y0A8ac7K67bbctB89uAocgY9QZ3wEEey7onhDi4Zj90tQZV7UIhXWfxlVV7SERcQh66AhmJrfnaDX-qn7cD1Vc-_Fm4PGn04KRVCTe2RFKz-pGiqqVZKiIQXWSVLRwyo0NMel4Xqq9TyuZ3nO_TQOOl5zFqC0qcOAF67UbLRIImEGnOxBq0xD6xcn6zneiY_FOXcs3q6YzXVKIzuHloe4hP5mEpq_TX2NiuoZwOiIhXGDmHSWts7CBHxmHAlaGK479pvzlYnQvcRmwVM7yCrrSRCA_L_vhiZ2DRy8CghFb9gAK9GlIkXiPyvwP-W10SoRkK1iZqISmucfXDSEx9Stu2qRdryI7KPf52n5cdgz2UkNBuT412YchpdvkVa343PikRtgoA0KlDbtQN14auOQcL9HvoKWuK8b5QqMilEcVm765vnSvj0SqzywEjuGjaSpcdbyPtp528k-ekexBuylq0QeQcrgmMmJ40iRG886XyuG89lLr29zB11aUZQ9OIEo4PlNXQIN2UwLL57AO1tGVgd7vAtQCmi1zDrFoI3HLnrVZze0Gjrtzyvo7stN5UZndJreEoQ-ejVAofmMedk0Go3htkgHD0QQmQpb8y_nQRMvPzV7ezMZXC9-Cp12AJRV7mLW856B6Ih93fjm9kzVEfjZlVgyYRwu3rsLYOX0jFgdxQGFvx_YGE66gSwzrpis5svsxmVlaaEIF-2FWG_imUqctrnXck_nIxk5EOU-2gCwtE_ZtTfXjrRj1KZhpjYvjNBJfRTbN5cPjdpJ5dORqwjl9woWuv85yTNewlskW-3n48Mb4WlIN67F5buYnBhAMIM8giLFs0_b4pLeZDOf3li6Nwloc-zg_DjlvYEZczyHOc3RSvygbOIFpVpE6g0ceHxBIhSNPtuqiHLQKoBlNaz2CI5QquVhyTgXVyJwP0_vpmfchkkuRIanay4UwpCY8lWPcn3SwZDbSw-4f2OsZ_AD4H2-pRkDacRDV81UTMJy_C_DoJO8xFywN1FVzQ4b20h0SBo-epH6uArfoz_DZK1Mtglo8Ckkk7itGJDPJ3rYpFvkFpNP7ydzOzzZw==.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
      format: "openai-responses-v1",
    }, {
      type: "web_search_call",
      id: "ws_0d99c78179edda6f016afcba29173887d1b6a5f8bb05654ae3",
      status: "completed",
      action: [Object ...],
    }, {
      id: "rs_0d99c78179edda6f016afcba2a6f1887d1afe803c216022cd7",
      type: "reasoning",
      status: "completed",
      summary: [],
      encrypted_content: "gAAAAABq_LoqACxNzvcP7wJoMnD286k-cSTImHV5a48nKnebIBW3AjNp-ShGMi0NwiDRVpVwf7yiOpDepmgpYP5CeqF-4cXcly972mnYEcXTKJXAFyKXj-wSdN0__MXH-i3cgodxw8RjsBqb0mmiYc53yG0D1s_OB99_Fst920cKQcFNDwLkA22zldx4zLCZqCZLnl4MbEmP4iQYnBeADQhE8P5D0Xx_I8CIohHoOY5ohC011A_PPaHRM4l0MLMZkdPbxw-Do4PMkcnTo584HdZQCYdgW2u6YnmyqQX0ZuWlWO64UToAgAJTrT4aEdNrOLkOwGDXJi7jpnkfxM5N5UhoP1NAe7qh4QZUFW1egU7pxTTNzYm2pASqnVhDiTTCthwX91iAYEhN_OdlcaDO5qip74rHM08uJTxybIwx7Xa_82IZZLdxD-g9aQSTCaGCXnRw4lovUpJeDvlo5CC3nf_mZxzHEp6AmKMzzVsyDg1qebCz34MJ1Hb9c043ire5bPVyM90iybNktfyKDo5jTsiiUml9BhYrl5YgCUt3bvpvThMiE0Zv_-Qh52B8fo2vXopsw8U2dZ05zEFWGIFrmSU7n_YTnHE0GIMbRMXQuywI7LTy-HDiTyv3ygy57huNJ0h7dscta9IFDCc7LCMud0cQTXAHP31QWg1wGjcLrZrtVUiK_WDMGdG85L2W6Qlwjka9tHeJdI8hK5A71CVjWCRD5Eyr97
…[37396 chars clipped]…
6TRexGPLR9Pym-g-019SwjGv5Vpxb1Sb1HCZdDF2GeIoReyfsBEFEgx8QH63MbpkVBZnVCGW19kBvwmpXwkcnz1MaQjsY1XEf9PR9eXmNlsN0zUNxFZyyOOvptwqg1HM8x2IvVpGJ1N6rNKV0LSg3IveLx7wG3JDL25VDPbKx9vp3LHSL7UgaWiyDxQWnRseJE81RCQzO-y4QhMsFqi1NRH1IeU_HPSmv65CfcKpnkhla30QgHIGcT8ULDGQR9zXw7ODgi-ld0RTqb8RngqNogo_ws4zZo2QxTlCpmKqRSVZT4Rspca72Qidh129PRp2x7-j7NMIqaa2a122LIrCf7NUorkc-56A_mfa7i2Y1BrglPMpkkzW6gAWmr8EQNdUXDzhzIZah49vH34rwe8ip5qSqIXPiii7mN-GiNG9ZFj-8E87wY3lMWh9dDTdjIzyk2w58j2OILB3-v31_hv0YQ1CdFJlR7XR_NOGawQhqEk0gpK9mDgvo0GxoBxojhLM6o-TEPK5gt1Nq1UOuV_0P2b_Dvs3ALJvXZG0C9PQTqFcIzKFzvSnWT3XJSPT1MGexZEPKqQykCg-kv4HWk1iFSQ5ZqMsm5MQoz19JOii2wzM-1n4nyU5T-wzHK-TlixxIK_7Reos--qczEKTDaK0l_psIIdGOzuWyxiNU5lhOGW2TYMwqgN-tvMXpPyDK98FZdR0WmoQDYolyK-qaqYkCJBby-P2uHhv2D_LTC6UHkGRQX5x7HSkz6wVhvAoqR0RFTdY6Rn1eVm6cCRQLbYqCZOWQe07937kdeFn7t83zXajAqtz5pqhFXTJkspr9tw54T9AWCMaOHBpTHskfuWxZA2lhEGAiONnePVOjlbwZ2xi5Berp99-St1cDVW_wcy-Nfrdk9jJMKSAsBJJwQCTwsEWo1Cy2OrMPXW-pDar-3kwz1dQFK2NMyO3NTn5At-i51Z6p2-qtalMTa2Ph8xbzINvHzIwakuNVxyGczJDjNz3438EJIAezWr6y9ZVM2-Wgytm96Rc-25O02HIU3XWj_6nVObiGRQ-Lq3zG_xHX8k_0MBQwfA9U3MGe4rFnhhI58lTSPC_RSG3gg_4I-enFdOzqK4n2xySK3-cnr5uYDiNaT8xCFgmPLnwRusuonuyZS0SJKZCHDXOh8Q_wopJgsqVdkEc_KfBpA2juTD0URFz88or1JnTEcmKmIAcbwhv8vWkT4oi8h8WWZdYtCa1spnEjymlNuzqHQZ7dwXLzIxedH3onAvVB6TehUqNGteGnNacpQVHN5ao5zDMnCY9FfiBpAfmOtIomKOPsXzz92KQpKFSF70WhqTOWlkcRuznZcv5NFR9mg5VMrOdfdFuo-iwxKldW8E7LFIdjX38Cpk1iGSf0tenMjR8t9Qev5T1hbsIqo59PHIrEBf07410H_BGpGYZfre9B8WjLIkEpwVVQbzSZyxgFQGzhV7aET1sxeHaZFKKqqceoIx4YFqHc4W99CFphtKsayklgg2BM6abWt4KaxhEkcHLWRvvLyPJ98JPnzX-hhcIC22dZnxSJGTv3AB3NYv5AGA2d-XVXkfzJI1T71FpjofaeT-fnPRS0PPFnVcncp0FQiT3KpdmIfxbrgU1CN2u91EoevZ5p7XaPWexc0VpLAx_zX7B_19nOQiJYvS7ui4e0ZPMBKO3HhH6UMGCHZ-y4o_LJKaHijZ71qMAcOq9b1bPu26g2w3Wpb7BF6sDREtWnh9wsZP-kpnT0F4-8cfBerVgy5AeOeDMNggHSGBjtt8rNyskEth1FxPW12Dkp5sw4Ji55m9oEWr4pJi2Xzm3g0jwayKacneyoX05IzZ2hRq7XTBA6I8zne7YyoSRCZCOOcLHJ9QmzTHAzM6wghpnSL91EI3Ig21XlVZ2Kw6XHX9SaKH8rF6ColH3iQn3DqaQ20FWqw7kn0Ftg_J6KiQxe5Q8rnJQB7Ifi6GFrw_GYdKbh43GWH4PHKSOUnud4e05263cXS34tBLnYAvfq_uLfpzBInzJxpMboa8OqXdUFYl3wQJ6dcoR3FsLqDULrPBWtjAClUVyttidauNiTPCeZbeYlS8KduevC4sxrhk8sjiAq8Rs5_o6p0Cu94cGUReXwgO-c4CSSIf8j7CWHLjc_wMompY9V3Eom96_4wJ6K_9urX3n5TC2BD5uVfKMbC9CmcP1wBYSeK9w7TcBl0Ypqo1SseRwFiyinVYgn60CuGqsRRHraBU1w9KP7o6--Ib3W052qx-YgeWJXVdQDbnVc3TAbX17of0IggLFtx68rPCgt0OOMZaQqGbgCjn5aVgSWw_3SEq5HFDjMz238w5LzHLhXRFliX1BXmBX_BMccmvI-v-Y6XpiZNP3IEe6-BAHE9svmy46eb2zN6MCIMRmBtEZ_JZ4VehM7DH9LHAo4TjJMnkjWow91m0GYTL6vJqb9pXubzT3m_AtzAEE5cJh_ZJHh1-0lg7XFu2bSluDve_gX4SLFd34j2Vgk1ejZD5MFtnKcE5Kni3eIcW_oCumKI=.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
      format: "openai-responses-v1",
    }, {
      id: "msg_tmp_6i1ufooevbc",
      type: "message",
      role: "assistant",
      status: "completed",
      content: [Array ...],
    }
  ],
  error: null,
  incomplete_details: null,
  access_programs: {
```

## Plugin Configuration

Configure web search behavior:

| Parameter | Type | Description |
| - | - | - |
| `id` | string | **Required.** Must be "web" |
| `engine` | string | Search engine: `"native"`, `"exa"`, `"firecrawl"`, `"parallel"`, or omit for auto |
| `max_results` | integer | Maximum search results to retrieve (1–25; 1–20 for Perplexity; default 5) |
| `include_domains` | string\[] | Restrict results to these domains (supports wildcards like `*.substack.com`) |
| `exclude_domains` | string\[] | Exclude results from these domains |

See the [Web Search plugin docs](https://openrouter.ai/docs/guides/features/plugins/web-search.md) for full details on engine selection, domain filter compatibility, and pricing.

## X Search (SpaceXSI only)

On SpaceXSI models (e.g. `x-ai/grok-4.3`), web search sends only SpaceXSI's `web_search` tool. Add an `x_search` object to the plugin to also search X/Twitter. An empty object enables it with no filters:

```json lines theme={null}
{
  "model": "~x-ai/grok-latest",
  "input": "What are people saying about AI?",
  "plugins": [
    {
      "id": "web",
      "x_search": {
        "allowed_x_handles": ["OpenRouterAI"],
        "from_date": "2025-01-01",
        "enable_image_understanding": true
      }
    }
  ]
}
```

The same object is accepted as `parameters.x_search` on the [`openrouter:web_search` server tool](https://openrouter.ai/docs/guides/features/server-tools/web-search#x-search-spacexsi). The legacy top-level `x_search_filter` request field still enables X search for backward compatibility. X search is opt-in because SpaceXSI bills it per item returned starting September 21, 2026 at 12:00 PM PT ($5 per 1,000 posts fetched and $10 per 1,000 user profiles fetched, replacing \$5 per 1,000 tool calls).

| Parameter | Type | Description |
| - | - | - |
| `allowed_x_handles` | string\[] | Only include posts from these handles (max 20) |
| `excluded_x_handles` | string\[] | Exclude posts from these handles (max 20) |
| `from_date` | string | Start date (ISO 8601, e.g. `"2025-01-01"`) |
| `to_date` | string | End date (ISO 8601, e.g. `"2025-12-31"`) |
| `enable_image_understanding` | boolean | Analyze images in posts |
| `enable_video_understanding` | boolean | Analyze videos in posts |

> [!WARNING]
>
> `allowed_x_handles` and `excluded_x_handles` are mutually exclusive. See the [Web Search plugin docs](https://openrouter.ai/docs/guides/features/plugins/web-search.md#x-search-spacexsi-only) for full details.

## Structured Message with Web Search

Use structured messages for more complex queries:

```typescript title="TypeScript" expandable lines theme={null}
const response = await fetch('https://openrouter.ai/api/v1/responses', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/o3',
    input: [
      {
        type: 'message',
        role: 'user',
        content: [
          {
            type: 'input_text',
            text: 'What was a positive news story from today?',
          },
        ],
      },
    ],
    plugins: [{ id: 'web', max_results: 2 }],
    max_output_tokens: 9000,
  }),
});

const result = await response.json();
console.log(result);
```

```python title="Python" expandable lines theme={null}
import requests

response = requests.post(
    'https://openrouter.ai/api/v1/responses',
    headers={
        'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'model': 'openai/o3',
        'input': [
            {
                'type': 'message',
                'role': 'user',
                'content': [
                    {
                        'type': 'input_text',
                        'text': 'What was a positive news story from today?',
                    },
                ],
            },
        ],
        'plugins': [{'id': 'web', 'max_results': 2}],
        'max_output_tokens': 9000,
    }
)

result = response.json()
print(result)
```

```go title="Go" lines theme={null}
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"model": "openai/o3",
		"input": []map[string]any{
			{
				"type": "message",
				"role": "user",
				"content": []map[string]any{
					{"type": "input_text", "text": "What was a positive news story from today?"},
				},
			},
		},
		"plugins":           []map[string]any{{"id": "web", "max_results": 2}},
		"max_output_tokens": 9000,
	})

	req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	result, _ := io.ReadAll(resp.Body)
	fmt.Println(string(result))
}

```

```bash title="cURL" lines theme={null}
curl -X POST https://openrouter.ai/api/v1/responses \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/o3",
    "input": [
      {
        "type": "message",
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "What was a positive news story from today?"
          }
        ]
      }
    ],
    "plugins": [{"id": "web", "max_results": 2}],
    "max_output_tokens": 9000
  }'
```

```text title="Output" theme={null}
{
  id: "gen-1794947795-raccqSKZrZTOmwScm8z2",
  object: "response",
  created_at: 1794947795,
  model: "openai/o3",
  status: "completed",
  completed_at: 1794947808,
  output: [
    {
      id: "rs_0bc57cc43a11be42016afcbad412f487d1ad0153e2125432e6",
      type: "reasoning",
      status: "completed",
      summary: [],
      encrypted_content: "gAAAAABq_LrUxxIx6HeOqVfMbuUtpQ40cwkpIh3D0oY8u3IZsipQIG8qq5jP3hoQqCfQHNGP4YJR92nn364lumeknQOFMB5LND0CzibasZNidQvnCBQ03F4UVdKDP7Fq18TUHhLlKPa64QBmHW6g_TaglwNygX-LQM_B2-ju2GQxGA3otWrR_SqBptinWlj5zVFh8dVmy4lgohVxxK7s0GcQ1VH0Vlcizh1waV5vcW1o7A94rG8Ez_DalZaT04XuICW74_Pvx8gtVk8kk8nNfPeXaiM1i3l8MyBH-pTk5Mrt1osBRx6mCvJfJSME95roVfNaimY9ThqquWMqypJgYffmwuf7NMYSJox63-9iuqwdRfSHrPP1ASK_Ytgw_1WZfoztovP42JHcWccqLAOD2vkpNRg3NMqYiax6rKfxWbwqy5tZT3sHP9CCJztGPtLwptIRX18GlpZqjC0TMKN11iZJmmKPKCNP9btOz4cLRmzs-eBACZeFc6KSxZLg3aLmS5zMFjztqTeAb10VUDgtZyzJun2XpJaYUVT9eiR9QfHc-hFWB7i5zrTXhB5osu_pNyXrvvmJWiUIvxAPgdn35RB-uQiboZDc9YafL89TyRZhXbyG5TAhS_2zUY63qJzEkhz6IooT4u3gOIvRWQ3zOmkgnU_tqL2fgoYvrO3VHXZkiehvjFM_eKo0Uo9Kp6RUUlZZjtE_qDa8S2N-yeJAccnxHvfoaZ5aUl6idcbSvDrHd6VgMIvx5sLecYv-3PQkrH9sOOEeKgyUnurKySzTh4CK9J7dmNtK-XWxLsD4NKjZ3IrBV2kJrdxaW1JcuSw-tF60BUaTFbIZYjB5yZfqcn13pQiGlJjjQfKxOatQGDxkSM9SUuOt5Fay47kLlwSTn_d09Ld_aoAEIe-Dz5HSXurzG2mIO2r88IXvgVDVD2qsuq35qg6GgZXgCcNpSm-4qAL9Yz4CiZI67BvAclsAe4Vs5be4sLyb4zFmNG-O8ndDjhgn-2ywzw-kULbpAjTWE-FTvUEvbvAfiLs2j9lcHjr7wEdsMM7QRR7_Dow5HctOa2QjmQYNyKBT8CYN3rqi9tISde2mxTEAOjs5tJWsyVGjw0oS_ZYStcg5qIJNkXr3saiIja7YbROTfTb_ecy75j-wR495iC36IpRYvD00D3Op0JM-I-SQ2--Bia3_5dBs7kvg7zyRrK2w5VI0yO1mGeO1aKkw2l8J0MWhExA8T_l_ndx-J7jwxo2k-mqI9Ptp66dzssi_neFV4dDIHVlqFLQfZ9WMUsLW6gRXxbW3EH0a8Qjii8obCe_Nuy57CINRAOF49DvPD0TcIhjISxSJ2HuxSGxn5GrE0EkMjW9bL39X9DsFee-PlviJquOI0w76ftcZWAqijQoYGudyOKvrK38NRf9-NacTlyRATPlWgIkTlytq3IlIoRe7l-eTGS_5zOJa2nB1RrP143RykkiLtJUGhY_-z68bjVC0gOBdh36y3M0DCwKgmcJVwJbJiOrkJfBJBGzXc2oVJtvFbqkLZ5DDZg55A7FBW8rv4PXg-NIzWj2DYKkFA5zVpiYyPHj-mWPH5DxjD7XPr7Ou7DZC65L8nz26LnbJNNCAGLZZrQ08Zfpc3TIB42c1Jz62nJS_XZSIco2099AU-e4vyxecSQUSWPaEu6tWBJA7BcTSg8kXZXL3V8Xufkfnx_7-IP4L47Z9tHvVpoDLTGrOX6QPkiloauXNCgZ_BQiBH5d7chySgF6Fx8CvuZdQRCIO5BjzqEmnPw7aO0bPYlM0kw5Xs7bCLbO2Gw_HePEHGHexnz7K1ryLHZtvRVkiG8yMNWOdWgml0PopAevIRP1o2d6hk8keRU2Aav-eopMeT_pm4ktSdCsp_BuXFPIe5qLNDaZNgRSN1jMxvxevydlQPM_e9WrflBpFlQ6Adzwp6cPy2wGwm5vTUI3khrhjDtSPZrIyz5nuqQhT_5kXNbP8qWiDp9InZXKvXBr2JjAaVu6rjDBGlvYJIv7-iN-uxR91oqwP6xZeEM3XJkmE5t467omxC3QpFB2fds6D_xPNgPxMfhQc-z6HGL8UBsDFpmq3bNXanFQ6WpgF9OOhiPMKV_z5qJppQkA8NXWEbd7-LBD9gYJuB6Me4vOK60HRSX8aqz_0Pi4Jzy6E1UZp1rim3HUhOxP-hw0CWTkK2LBCzbIhEXPqT3J76sfkw9rbLSlYoSv6Xix21DYAiQ3CtQNAwP8QwFTHdyKQdXwy0F66z9iNMnn_08ffw7su91j-iMlVYjQQeGcA8bGRPCTmj8TqWEXQPYJL12izOhc7yBbo_kqjALpWWubym7Kudkupqtc3FAloSC6EYhW15sOaoAKLhwXrryHpqRrb4j8BkLCqZ4vew8pxpzv7J-NNnxD67-VdH5P_Mdsk3Y6xIDoXo4viOyocuUeG96wQ6YL8-VxqEl9W_escfQZzGlncQA==.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
      format: "openai-responses-v1",
    }, {
      type: "web_search_call",
      id: "ws_0bc57cc43a11be42016afcbad4eba487d1b82978b412aad9a2",
      status: "completed",
      action: [Object ...],
    }, {
      id: "rs_0bc57cc43a11be42016afcbad71ae087d197e8c17e09945a14",
      type: "reasoning",
      status: "completed",
      summary: [Array ...],
      encrypted_content: "gAAAAABq_LrZEsCu2eLSYtpWUI_6APcrqLOVbCDY2kV-QwxFCGPtu3pZnLrTF1S8qqkzXORn4DVjGyar2BwexmWUP9OjN_yuSWdXP99YNkffbgl4ehT_AddvneMseb4ThBncluiYH-bDFyofdjwYW2NRQoig9FEy-uwTEOHePHGIDVgKPAcojsQVJXAHcTVdmMOMBcSDJNpTJyR4vVzwkv0PXhl2ljWnRCXoeacAqLbGWZ331MyzpVYOSzZdu-a8Fl5mGZiFCeAUGIbMt_tjsftoz_G3dtkqJvhA1Ou292WeJ5SPCW13DX3YSF9b0H0frgJa1R3xETDMWXRAWm5IDS6FcbsjX-62NpcZaFF3VwL7UcdJ63hI8PPYu8vKyHUCM6wofsNjN377jRDTTN1lvVGzhoc9BT-sGznzlbyxLUpZT8b31tdQJb_jbRhbaFpHv-rRJVlGVKmc-6t4fOY-vZKi0TyvZ5aG3ZsK5J6e96yc9uJnI217agtIaDEyScsdbHyp07y5ZuUkeA8UxnNyBvxVjm84_peU_TMJ-xlNmUfNJx6NwoQOGHrNVpppVm0wsr0honpJRNCZHvHqZOC6CUvEAf67l_1uJ1hfipySBLcsrgxL-7GWeY24RL-tQUDZVl2CZE5YYvG8X2Rc36K5cX0W9P7FpaM5OBA2g4LDigS5kzav44qIBUP5ap5ggHxp7JANSLQG9qq3xCo0omycjG2um1kyA1
…[6927 chars clipped]…
TDxW3gKZZG8VM7jU2pXwIlvjzlP5W3m4Xqu5hPJMR-mSG60Mv_TKL1okRpaYkS1V-RJst0pePovy_FOIEAGzUGEJuNY6t5jPiwRTtXYgzjxbnfKoohN2Fnl3SZ98Vx4t_lpa6OTHfDgXczFReHnIfCSAS-ggUg4yAw1GwVNbV1bV0yArYaIG9bJOWvqM7RCBh3d5bnzAW0L8zRmioREtFGY-TRLzcTEHkl9bLeJji6_ecL915Q-kMK2KwIWIu85rafnmUZgARwehiDFpnw5H4O45NHGUByPAxctVzf5fePZTF-aG_g5PsYyBckD-0cs0UMEGlFVzzNqSgnMtZYA-ba8rrPqB9dwqGQQOVwWmePkOx0i5NdJt68wQrcBPfYr8VEXLSNCGdZdb3CDu9JGu968Umb_IcSVfMnxXPmy6jbpXh1iqbyiQtCHrBBsz8PPRiXtdDf_fg8SEH3XSp0z13D-ZTn0ZChnFyS6cvTuCz-Lh0hjlhJWJSjrEjWai4Z8HiChyD_bSW7ENwae00kKCIGoeDc8ygmTFYkyr0WXCRY2DLcqtQ3PIthICMKn2A-2cz2RzcbfDaJ0SDailyF45YjU_6rANuNes3D_xD1Jm5kMiA0fpRiEjfa6AiI9dmCxdERrhh7wTdJcqA0Tc-XtKWZhF3pipW-hPXs6_3KhEs0g67kwTb5viGpRS5jWlsy61sq4s_P1h3OEwyxUsRrND9vSTD8lwOmiZgy46Go0UxQhuXreQXqnYCH2RPQC--fZlJDZotWo58ucX4bNMoMgaubGkPmTSSq7e-yd3A-Yl619kQLjd-iukOeZmNREoZDlmbffw8aBWtll_j3qajmNJsnuBGnwLE--mNxoWzxrUpYmm_j2wuMEXJuVQl2ClzumBITFQ1s1JFTTEPa9k15VKpJaS8RIo3v-MsSJaxEm90hGRxn9dvxF90NfKdwxBFyynbA9XQrLGQhg1f0eIn4FsZJOajenlmLRtxWZ34x8NjxX4G_uaA09c-h9cfYFV55PTIBxwbT_MQHi3BmpLx3mtajJCemP6ZlHwTsipNkL6B28BcviWy-z_hWaJWhecPNym3gbveXASzo6hTXaUnVI-aqrl-Iuyy2XCaCJyrJTnoEe3DqGHI-mJZa8rWNOcRtfbGqfPrELz9_z1rAhKrQmvxUYod6KXrRBn8f9MHYWY_x_9ANsa7ndvA-wUZyztUOZV5gQO1jsDzWls8SzNBqEOgH-eRsV0C30HkRti7oj1P-iyoW2HGmY4t3n6Mfj5QdIyhU9aSXuQ_gNGnOESTgqDL9l6iqIgGTxLnlQ8PWkdBPlyOhbAwUMpsTtpixabI_-0R4nkIZDELCAygWmz-xLVL0rj5XkvKS3zkM2IyComHOz0WZv_PF0p8nMmcjGoimClnoSE0BlQqwLHKptVYvfyLJsmCiOv_CcYJQIqsp0mePZDJ_V5l3NcDTms2TzbGQ5NXaV1aWmsB937j3Q_ttRV_IaztYgVp8ZJuc8IVOZdMHD7_dqn_EDYZY3kXLzjF8dZhWeFH6a0gBX2c6kNhgX7azvDshfQUnOTt5QexkFd6HYEfA-8_03Ng-b1pbKZuakOVWi7zmdhQbvadjoDSvOj512bqOK_69OcfM4ynqthvon_nn5MoNI2CpATKineMyZdEdDDzBKTKZbSV29dDvKrwMvJZqqJlc-elgEeMuHoaG9a7tc-84aNZ5Wf2Ik0pD1j2hgaejiBZKoNiFLZgz46MnJeMwIwuS9nd2lxCP3jrMwjHoKTJnmCcDGVoDfkLu13W0MWbmVND-IIUd73dzvprr1L8faml9FeEX2TlHfYkze7vSYkubh9u-sh-DjKZsQ_9arKA6ixbPY4cUrOjLywK3xQu0GoB5nHqyBZ8TZiwghRICiL7SIb0Hotv5qK1_3pe4UxLJ-MrfCNgOoZxRW8_56ETi5ZcFcPYbmwY0fPnGglH4Yi-gbjCrA00azXAki-eXdMY7YxB0mtVektPnycnVyBoY4UHMTzPHILjPuhDcH3fqP_Soe464trFFROFQvEEww5LE8G5WUE3o-KGhnPnZBCZ7EJ00H5Awj3K16imV-yyaqMiyrldBp2EOnrPRnlmaz4Jd7Qb6RRrazJTi6hTvRRCJOGmEHqQx-QNm0ieqydAm_Ohy_rVvKN8gSZnPD2bZDKRHRXHA04PHKlElFKY3pjf3138zh2xPS-uohZlSV0bElv7XlEevOC0PkgFUaZXrOVFQPva1ddwB3Z-kCEHfXlZXxkNXOAMyVkJi3IDBpbsPTcE41t2FYX0KYTNJ8UQVXGT8FbJyfaus6qUM_WDxeIfxT2tdShSJ42a_8RbS5HnpY4EMqHd5JJNHM-z415vEjv_mMOyjoHNPRF-16VGC449CDnLosH8DCTOMtOVHpUcMU_Es6DnLt9Eco7miBBtp1GC3L0mG44H7dHl4Thk9iYZq9DKWQ6eVdiqv6bLJfv3sdfxET8qW2q9m1mcJF3V6bsE4JNK0-6BLZm8TED5EL_rwrFzSV8Y8N9CgQ==.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
      format: "openai-responses-v1",
    }, {
      id: "msg_tmp_qut43dofg3",
      type: "message",
      role: "assistant",
      status: "completed",
      content: [Array ...],
    }
  ],
  error: null,
  incomplete_details: null,
  access_programs: {
```

## Online Model Variants

> [!WARNING]
>
> **Deprecated**
>
> The `:online` variant is deprecated. Use the [`openrouter:web_search` server tool](https://openrouter.ai/docs/guides/features/server-tools/web-search) instead.

Some models have built-in web search capabilities using the `:online` variant:

```typescript title="TypeScript" lines theme={null}
const response = await fetch('https://openrouter.ai/api/v1/responses', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/o3:online',
    input: 'What was a positive news story from today?',
    max_output_tokens: 9000,
  }),
});

const result = await response.json();
console.log(result);
```

```python title="Python" lines theme={null}
import requests

response = requests.post(
    'https://openrouter.ai/api/v1/responses',
    headers={
        'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'model': 'openai/o3:online',
        'input': 'What was a positive news story from today?',
        'max_output_tokens': 9000,
    }
)

result = response.json()
print(result)
```

```go title="Go" lines theme={null}
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"model":             "openai/o3:online",
		"input":             "What was a positive news story from today?",
		"max_output_tokens": 9000,
	})

	req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	result, _ := io.ReadAll(resp.Body)
	fmt.Println(string(result))
}

```

```bash title="cURL" lines theme={null}
curl -X POST https://openrouter.ai/api/v1/responses \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/o3:online",
    "input": "What was a positive news story from today?",
    "max_output_tokens": 9000
  }'
```

```text title="Output" theme={null}
{
  id: "gen-1794947899-0Gh5NsSvq4gktksSiIkO",
  object: "response",
  created_at: 1794947899,
  model: "openai/o3",
  status: "completed",
  completed_at: 1794947912,
  output: [
    {
      id: "rs_00758b1c1ebe0100016afcbb3c4bfc87d196d13e1be9dcef79",
      type: "reasoning",
      status: "completed",
      summary: [],
      encrypted_content: "gAAAAABq_Ls9hj8JSnf7Rak1FV5VsZyYQRRVA4U59i_tpb3I5XOXuBRjDKCK_HEQ7TdCncMs0uPOMM9i7bahqw3HrOH1LJop4DNQhm8aGzA4zRgKbB1Wo7Nc1htptso5CHxBVF7qfGDdmVgu6P1wwcel047l8T2FEEiaGgdaaggKmuHi05MsL6BkwY9fIu9g6O7P4SPsWk_5MmD7mTcpso3hk9Sw1fWxfdewR-OzoD6enyDLdz8TfQGUGo5q1XueyVPbdTj3ms4WhBZBBi72u13_J-jcmnnybSdvxf9khbgWUwBizutnW1IKvh7aVy5EfgPP_X3vrij_BGWw4fPUv2iwUKIRthCIf-PDbN7w6BEZLwS7sHZSz1IiEOJOrGY6zNnrQ4Oz8IDWmdKtIaL9dmMdw3Mln8nEulO6W8pMZDD8_c1kd995tuI-DQEeAAnYYtKpv0aVP8fHvtyUazTTsDx6fozmhHNNhj2U17ULcs-fdRcNLDstQ_OhEZr7b1rzM-OBRswh26MooGbqsSCLDKraZrw9Lw6OwllETixeJJL7rkCPxIIe_wvXovZI2MGMtlz_1xZjeVetDsIha9wfYJbgt2IQHYpbcZAL2Po2z4N4z4tTOzBQDN3WM069lBjGDASZYZhrqiPOPYjxYwXYhkgTcxxCvC7qvlwPIB5Wdm9QGAttXS0w-XyCdIOqGP6zyve4c7F4LeZ5rG89DvA1J4QD-XfjwAi6CDFWA3dNUMyLPuJg0xORBJucYSbtiq6H_z0_SHVas06GgTGmO54fo1H0A6Rf4z5Z-_JAkGo5SXhAlPVmsp1h9bGtlJb1El6J153Xda40Lr3A_5zTP5jYOTcIj0TmLarjae9l5omEdmxHee9pfrJqjzFXx2xz2K8WN5vd4IL0IpFA2xD6GloRiLeNUsLlWfEXuNsIBs7HNSPT2cNYTiUdolMxR9tglLtd-HTlGn8O86Q9aUmW9l-zWbHBVajBcd6rrBuckNKSxRTzvVTppDuP8Ud3e_GDGPpMBiWrWQgxomxDi4FVTBS5IGTjNgjx8PIY4qSik7sJKjt1sNHdZSvGvT24qrg2IICm3HVAu6Yl-W8WtYC3ohbRpWRWgp4MXIX4vbGZbdQfIZoP24-QMvcfHTSnRVdx1n1Jn2vtHH-jHXMuSADgD86VDcvb4OPyG897Csz3ixE5aYacx24vZVOSA9vh-866uS_eA1YyzyPMAYY_aEYVYo6YGrqdgd1VD5LaLrJiNyFSVFJyxF2xvfhzRKdWRVRKAIDKpVbGNt2vRwotp0KiyP6KGwzgpPETNiSOP-ta54M28Iu8gQwbW6Ou70SBLaEWiiC8LKu6rhp89krbE01TJcvzuBleXpDZYwpyvQlj7LGoJSr3WSkB2123UVfgzc4gxassohmOXVLrQI2c8wQbJFIVT3r4LWhmawn_hzkz1zyT63hvGATDLk-88RctAtFpG7NQsrVAinZ6U4osZTTn3WmoMknFboR3OZ5slvoeqHjbL1KOC99s2roKNY_Xf0BiDhJzO307ksLZBbyv6SZsVsYHE3Kc8PZ42-Lrz9nCCUSthluKBKg2T8IdCnufB-LR39v39Pq0QxHXKv8YPFAC106qQKz3o1_BX97lk_bOTDTC77v5znA7bQPAN5Mp08R7KReN4YhBhf09N2ZDX-NyJse10hhWF8CbIYOlz821pYefGd8dfqG5W_2_M1inmABDHm4IPPzyvejWOHxnc6qf2Uiiut5TZ1Ozd8Nf0wu5_Y1D3TqdUzcr87JMSQuaq5wFkb81BuxM7ECCYRgDXNu4nTqQpUibsKt0g484rz8iDHQttgcTGxQ-rPW5BUHJrHqLgzrOYDfUkRs2BQNVRe9neE730pCgrAQYWDS_KRvAWoooDEoAnyKE3hijW3XRez22YAGBaQ1TfBaUuqStuxB3aAEY32xXY2qFAoGN4YRV_XPI7hpYXyGAeWraB21TW8DmR33dYZVDWU4FYDyOiTQRo7U5Xa-RvkRtjS2vwriJGwv09lmItjCsf0wdmhFRH2hKgS__S1BphG2bqgcanR1lJpxPtUPjqxVfnZvoMTsxGyPm10axNUmH0VgnKw97cOh2E8GDBvENzQi2An2FpuCEn71TzBjwds9iU19P0AYUJ9Z_KlvqGOxoHHNJ9Y9I6da-o7fslvfCN4C1KMS8a-Up4FFvr5TJveFr6MrwbsvSf6Lqrxg3ZhG81mKPobSRKaS8dOBrcD6ZdLDE8W-v-q43AcqZqXK7TG9tb5I4KbvMwwSA1EU5NeO93Pl2UAsas3Zxfljow5D4Z6OJ8rozkOQ0nGREgNF3RD8J0UxldYKob3aSjFXrLYxuTN7MMr9V2WnNOPoMBvsafnpsPIu2eZIe9HGPz2Mpq---Yt-IodQfsc2xBlr-5ntN6-rU4F8IRnqjg6fgueymu3-37clLRsGVm0BRz5IDdVTfchgRSEJ-u7YPwMccsduSvofXZfZGd0ZBJCfQ-gZVuIY-wASWfbsufkIBcye4-y9AIeIqFY9hf3H2naasGPMLZrnPQqSEeTiMH-7WbZZXHgJN1lx2UeGBr2JO4Wfckt2eiDQJLtlDO4jHk19UgNzgmOJ5L2AbzikRISzUZTv1U7S9Yyzfryf6eHaIc7aTrXHFUdj3_dlUXjqAsXLo6Nk8NDOzFD1JMZ33j73Lk02MN1tbWQ6JW6yCS0X7bTZxGwvLidhUtUaQ6x31f2tu5DQ7dITu7W2TKfBKi61-O6THH4LkGh5-.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
      format: "openai-responses-v1",
    }, {
      type: "web_search_call",
      id: "ws_00758b1c1ebe0100016afcbb3d028487d1acafa93a4e87f29a",
      status: "completed",
      action: [Object ...],
    }, {
      id: "rs_00758b1c1ebe0100016afcbb3e8c0487d19fb9822c69c1c85a",
      type: "reasoning",
      status: "completed",
      summary: [],
      encrypted_content: "gAAAAABq_Ls-0kqO9jgfT794JG6Fe7FwgS-ppjCYn0IN5j5IoMDh4-CKrxSARkwi2ysBOEwqeynov17To2WEYQnjHg9mcypB4ku27r2adxePNrefwIiMsvXohxnhwr-KNBdx76L0ZNYkZpeTRC2TSssgMInE1zQV9JgIYOfcQOQcMgS8SQv9FcJLZU_GBpOlLUwUvtsDMLgpawci4mgf1_B-Mhwp-hv2OB5rVAm4L-Z06ybp6fSG1KEVvY2qfvgoJUupYP6cAcEv-Tu2viGQ4LthsfKHYX2MsTdlohrM9tgItpJyahQ23XG0VwloYVDmaTgZuX1rttr8XfZ8lMT5R0Myhrt12nBPyDpPIZ4Qo3-S2mVB2ZSbp2vHvqyvE8ZQIrKDlLzOs9-qziTguuyTdY9sRbkmKgJRQXIL33d3XS6zD4xFyDWGoEETyQoRJXs
…[8907 chars clipped]…
3BW_qDm88rfQEampyG_mxso3XWnuL4JfcyfJHR__5GzjkmQfb7L_nlYBuZxtVUW-dnpVsSkVWPv1FeZ-3IrbEdvSvOpoWs8J-Kz3N4B8Y0RnJD-Yji10WWg5hQ-11nPg2XEhwNsxxrSCwcjyvllSg2vaYiaICoyV0TMqMdkbJPlEHM53E6-F28_FMu_tViNzb83RkbGKnrFSjJY0Ml9X-Os72H_7eXRzZr__rfM-Ksvypv8oyFczgLR_rwpGZjx_1kYnh6PUJIo4Wy4RbdUNIufz3FhW9Tf_A2kigi6hdAocRNDTzXKKK9-SwwKSfCkx76PfshVg591GsDI79EVnM9N_X9-A_RQqrTODul6LbV3QXx2cWhlmdIbnsY0OeYCxaLbvoTBN5DePHktfMVu2cQ1VKlI8OQvlSxjpcOskHW4SJcQzinYy1AY8RmUcsSHN7JhfM8kJoT74tu7ae9NALdf7UOBOdpDUxjjyk7HdbOI4lQ7Try1O5dzi3x3pyaYmhYvtUfVhEnHbz2p0tsJVfSwlAwHziuBL9brw9TiIky03bSplBzB5aPeliBFoaGPDFOenamdZCJJeSMitX-0bvv3GN4nPLiXnoEVaewzlQMPc18naBeC89LMo_punSC4WlNwKIhW9sSVOLLT5g8PVKYpz7oOONrUuO6aMcLf4ZsnVXVMUpkasUL1p3WRpOaTPxmEJuaBEYOGbT0VA3MXkVbymS3PpDxkZ4vUrF5VCbcfpxwFOsX-spv45QGc4ilk-2z9CoMDMBrJD32zT6rmtoAIk2gw656OeQEi0pVwqP67qqJHtdZ59tOL_ftsD4XkDJUBSaXt5t98rXGWzXqfDe5xkOqis1a3xUXi7tz3l4CcO-sCMtSj_zt__KzumxEn9y9pGxiNLIpiItSZ-DVgkipgeBw1hNyJ2Hk0SV0sabkoKwxNg0e41Ey3a-B3ZWMfBO3iKwdti4hDQ1rxCKs-OoKHNdAOGDzxmnDW3_OLqW7NcYPBnQ9ttW_qH9K5whW8QSKJtseeVgLsRiQhkV_Rdci2e6Xrlul-L05v5fD9tlH8KjKhvLBP7_6JHbbSLTP-x_oyt5REFPyxHpkpzhrboFZN1FhEYThptd5fV0Tec63je-tWp-EgCHD7yzkQvbSiVFLcTmm268c9hQeNLrk1jO0H6WfFnAPm7i4EzfMzMap93K2bS58_7qx42YZtjcJLBomXTobXnGrOb54P_rgJ0ylR46WJ7xsDhZRN9eNoqpBO_g9cWzkhgR1kL6mLbUcl08JNzEFoPDnWEUk66ItiPhHO7UGgtJUMhLZP-Ug6KOlp9oyhUObNK7NpaugITgtyHTch7C3New3WsgSKtgAtwX6yT0eyC9eh1CZzGNelD7XIQQnhYmL9iouVjV03C4mmqIW2JGrybncwQESnKysP8w6aEsUKQ8hp3b-IwgK_wvVpNvyaiUo2A4FZizfhOHUBlgvixrbZaW1iZ1ZBkyg0WNW5JeXNL0-J8ZMIygoWmKZ5Lh4Fkunpl7vD2j4vT5HeMr_B2EkzJMfBETBOS4kg_gHlgaRRAtLm5VudGNC4iMHiTx5KDF9irDVEvt9jZ9vbh-n6939R_Bw14qkUrlCe820DnOI52bXsdxAZLXn5mn_a-1bAdclWrbQkHkjyj6r8YzSW3M4ea8sW6PemCn8ehnVykzmaF3i_IGFJCTMPbzDTNjE-Ku9D0XLk0io5TVDPoF9dxDmYQStXLN2be8IhCGya257XV-Huv98JGDgt3SyQbiwMlFiBDQ9Ig1wG61LSFoFlm9tBjGO31LVb8mYXMr3H5r8QJqThF3A97k5lPCI0olnB8JeDZs8dee_YR7YTpX2k30szM4zWofv7V8Oo62B5mHKEU3Y7s0mGnDy6jxqqEQtpu6cgGGloBRhnW6O3Ie3yDjCi-kCnn1DobUxoh0QgdED9lpjxbxQ6uduJtCk3Kgt9RDcZTc2gEsVZpLncA04I6cXly7CtlzRa4zmmUcjOftyJte6CYB0d56RCyxEfJkX2JxCaOUKBcZlIfmzJkkTOKLvUVzVIjaWauBWzVT3pyQSTTUglsGuNOjhiDtKsmEq7Yje6ISEyJ8SPOiRlguxYHtAApas7Bm0V_Znefr2jcb0mYhSSVqB5cB0tnuY_t8igykZke2LwVjhjh_ohS4OJiDiZG_kwcBI-EphpeZdA8Ix046sNyE8bimxu2qSZgmvMt2TPC8Bd7qqnvHT9-j5OtM8ytXcGeVBf8k2UIJlRLERFa_q5C8cVwgRFxctVJbEmzo2XoRxpOKgWZMXJ5LXYJzb6uaOs5d84guS7rwCorQ7Z7tjna6dtHoxHZws33HG5IOgP_KUnZUF2BJPIQ3GvtM0L6UmdT6UkvwIqOUvxdtKROtSd3DYbA5urpDvOE2nYl7lMxG2CBBT5zSrCm8CF-fqesNSeFKq25bzsDPw7JO0NY7kWHjcik8MWLJesyQj1Fsix0RP2DqjJIiPYDLSZnNCmGxZut96EfuzlmForCD1IrRy631gjpVI=.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
      format: "openai-responses-v1",
    }, {
      id: "msg_tmp_35pohxxocxq",
      type: "message",
      role: "assistant",
      status: "completed",
      content: [Array ...],
    }
  ],
  error: null,
  incomplete_details: null,
  access_programs: {
```

## Response with Annotations

Web search responses include citation annotations. A `url_citation` with `uncited: true` means the page was consulted rather than quoted in the answer.

```json expandable lines theme={null}
{
  "id": "resp_1234567890",
  "object": "response",
  "created_at": 1234567890,
  "model": "openai/o3",
  "output": [
    {
      "type": "message",
      "id": "msg_abc123",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "OpenRouter is a unified API for accessing multiple Large Language Model providers through a single interface. It allows developers to access 100+ AI models from providers like OpenAI, Anthropic, Google, and others with intelligent routing and automatic failover.",
          "annotations": [
            {
              "type": "url_citation",
              "url": "https://openrouter.ai/docs",
              "start_index": 0,
              "end_index": 85
            },
            {
              "type": "url_citation",
              "url": "https://openrouter.ai/models",
              "start_index": 120,
              "end_index": 180
            }
          ]
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 15,
    "output_tokens": 95,
    "total_tokens": 110
  },
  "status": "completed"
}
```

## Annotation Types

Web search responses can include different annotation types:

### URL Citation

```json lines theme={null}
{
  "type": "url_citation",
  "url": "https://example.com/article",
  "start_index": 0,
  "end_index": 50,
  "content": "Excerpt from the web page..."
}
```

## Complex Search Queries

Handle multi-part search queries:

```typescript title="TypeScript" expandable lines theme={null}
const response = await fetch('https://openrouter.ai/api/v1/responses', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/o3',
    input: [
      {
        type: 'message',
        role: 'user',
        content: [
          {
            type: 'input_text',
            text: 'Compare OpenAI and Anthropic latest models',
          },
        ],
      },
    ],
    plugins: [{ id: 'web', max_results: 5 }],
    max_output_tokens: 9000,
  }),
});

const result = await response.json();
console.log(result);
```

```python title="Python" expandable lines theme={null}
import requests

response = requests.post(
    'https://openrouter.ai/api/v1/responses',
    headers={
        'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'model': 'openai/o3',
        'input': [
            {
                'type': 'message',
                'role': 'user',
                'content': [
                    {
                        'type': 'input_text',
                        'text': 'Compare OpenAI and Anthropic latest models',
                    },
                ],
            },
        ],
        'plugins': [{'id': 'web', 'max_results': 5}],
        'max_output_tokens': 9000,
    }
)

result = response.json()
print(result)
```

```go title="Go" lines theme={null}
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"model": "openai/o3",
		"input": []map[string]any{
			{
				"type": "message",
				"role": "user",
				"content": []map[string]any{
					{"type": "input_text", "text": "Compare OpenAI and Anthropic latest models"},
				},
			},
		},
		"plugins":           []map[string]any{{"id": "web", "max_results": 5}},
		"max_output_tokens": 9000,
	})

	req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	result, _ := io.ReadAll(resp.Body)
	fmt.Println(string(result))
}

```

```bash title="cURL" lines theme={null}
curl -X POST https://openrouter.ai/api/v1/responses \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/o3",
    "input": [
      {
        "type": "message",
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "Compare OpenAI and Anthropic latest models"
          }
        ]
      }
    ],
    "plugins": [{"id": "web", "max_results": 5}],
    "max_output_tokens": 9000
  }'
```

```text title="Output" theme={null}
{
  id: "gen-1794947990-oBsbOZtFmZHLkpgGwAgd",
  object: "response",
  created_at: 1794947990,
  model: "openai/o3",
  status: "completed",
  completed_at: 1794948035,
  output: [
    {
      id: "rs_0a4f6695c27438a2016afcbb97d1f887d1a3f2e08f1973d1db",
      type: "reasoning",
      status: "completed",
      summary: [],
      encrypted_content: "gAAAAABq_LuYWURv_vewWwmpZslxdNdA1g7NHwdyRV0fsn7hTUtIFXt7t10CvBic05BKLaiz2yBRaMmHsDYF3_HKHQLoBCs6a9leUC34fldA7DaHi0PMm8iiLoA_kzyumtVgG48dboDQOfbYPKW65b_V4SZf6waE5lna9UkjTcQVuV8_CXeOz1r0W8jq4AJcE18R0xFwP2TrSGKxomjXh_3e2AQLIkqjgpXLpQ9J2KaLuZpfkPlRHWamI-vuCZE_8GIgIKSDFFRfztlriVoIRjBAwOXh_FfityY13HHSw2GMehKjVmF0-CGdnPuRoIPYVtlXwTgjgmnpKhYGwTiktmhUMPiDXnKIajLNtCmHnFQvreO6DIdtTH1owcORDDoHyuT0mNbu9RsKbJaDMasx7_EaNWpf_dfvTQUkih0DAk3wYGwgVXmP_7FrWCqb4_4GXLjmNhKklc24tvw8oVim6IE0MdbEsvIpJN0Tn9tAjOCKLAHWN1b2dWpKy7LuR8fpOpa5JsRIacURonlaHQkxlAp_C2Vzxu1Hb1ct3O5GNRxmnrbS9EF1_rECPfsjS-WRGwzCcnG_bnOUPLeZ7_vj4LHq25dMHQiMiB9D_ywBC--x-7Hd-q65TuJNwITRZJVb9_I_yfOf-oQKkyPFaBt8on-tgN53gm-hKbvSlHfYszfmsNvKVpBKyI4L5gWxNqBLM4jFfK3q0XzKxlf6dX8UJtr5E9r7D5nza_ZQSnd3t1iJqrb_w1KxgjLIzLe49SuFzH-hRZKi4sHGzcwMxl2BJmc6ec6wbQJAV-SP3SZZhUyvyJwYndsYRf_g0oyTrHQSwz3QuvG8f_ipTr7Dr0J9g31j3_bF0yf50ietPaxhhTSBuTyKeP1QCPtZOQYp2Kvp5edKxN6Rq3MUd82RLy6cyj3IyhN1NQ3MW2SwDkHbq2K8Ya6PhcBSZC5EwBFaWipgqrpkc53KFOR-lf9d9AE5DchD1AbAEYMeAXYHs8ZpLwnH8jv2HV0aLkSY6remaJEmlU7Z7YnAFh0D1yxDNmMuVQ61bAXqAl3R8VYU580WpTgZ1vvy0lFfgZI7ciWeaFmpmxT9In_2X4AN67oV5ywGBwwzYdCQShwgh06E6yu4jhEZZNY_Hs_R8HzC7XWHgdbt2UdzWrz1195CVYay_SnlUKYux3GAuWsmYX2rc1QQPg54bIdCX7r68Li7s3UbXdsVHSJaEf91uf7mg5Lx0_ivZAL1e2ZTh-E94pvGjdnh9PQxjyp4YEKpsMDxIzJKbu9sCdFe0foc6AcYaS8xZ86vC6v78d9KUdkc7rilYIv_11mIWgL2M9qvutgAgrQ22Z7GGwL7MM-1O8ewpZy-DDZWraBxhXWMB53i8nw60jKiCjmHox--J5DrmIGgPy3guDVy4UWUgEB8AdxCQx9tctkpareFsE0Qj2lMZwXrYpMdE3EZhlm9wGUaSLw9JO7cxG1b5eQpEuZedmOMeTJ41pYfhL7x8py8_dW4u2ICWdm-RYTCxLkegCy9a4bRN4EBqnpOXtbgeAYGsdn8iFSvEDuCxXL5LF7GSoh73lzf1w35lHa_3D74iEkiffEfSiNwsokMTe4mIt_6podogn8lY944NEjfZUiys9fwRAe3KWq_OoBAa1UK2DWO1kc3WdmyKlwY9kvAp86QAJW4nq_fGzhv6DXbQs6K4WxT7QmAtzeXJfzT8ghPmZ7zWNhH25NneU5qtTOS8hB1uYjkbp2O3AFKUVjQvF863Il9IQS61k4Pq-_hHsMTWWBjhmh6wmRChYBeYYSGtcVmOtCw5BdZfPs-XVHjkdJdmaXzMzbNvRsEQHI9ihvUKLvvFm1Gw1bqwLJuT0Dmt5d6uwKQJVeP-5dKIFQuCIAyxJ8d_UF-bZc1fu6DysVYY5U76QPxXtHYK-EbzRBhbtfNRcmZTUWDVmQ-CCos2b4qi6ydBoT3zMcp6PCS8gTgcqzi83yhx3K-lSueesFTIT8ws8GhTC3vzkUu8BN40tnfKZBp7yq7C6FE7gK8ikCmHAkfGYVcE-GAs2IMP23rZHoeAJQwX5I6K93C193-beXTpYT2kRWukRGyGBqtb2J8lArBKyJ_IZtyP5MFHvXPZEFOtbCRfdLNbRa-RCRmM_Arwe6Ulf2oIGNU83dc2BKB9_dVrkUgp4LYbuLHywpmLidMbj3oummG6sFePLHZSkTuJ4cPJpWXhQnf9WmxVkQLWFIxzt5U_xrCMKFdI23xnfkLQXBnqTWCEfDKrhCkfCwaIc2Ps9pSu-PGyeg4UTcQPOqg1qRjoHa8G-DK0KuzLG2LEIJ-wkF8nw3EbFnM1ipo0vrH9NrmoNDSs2fgiBS6KbeJ4RsSG7iJLxluNhCRIOYfjjSf5WKlnf4feKYdnA8v2081_rb9l_GUvDgbeC-RVAdzDIMZ9zwFzK4AmrIEl1V59HBe9h17-l8V8xgG57vGfYgpFvqwhUswb-hAOD1NjENr6oEQZxsnfJXLVdC46L5XNK0q9qkQaOdXXFkA-gxxM8PQ1qhpq72yRm_-qyU6bRQ-okhYgmfiVsE_z1x4G5BtPqVc3A7WPPLvW0KTrsjlMoEzG4pnVkb4fBOhD9P51iCJJvvYYt9NhJ-R4dZMkQL42t9ONkK9EvFn6eZGSHHIRQqWBkGBRAOv27bFwQOC6MOUNWWJ9A-M5HYsbm3yWIfpqJGeIgETdZ5GAQk5WKOxmV7vtkD9o-EjcEsmfHslsWsoHnk3kxh2_zQ6DAeFkwKK-ZjSmW9auqJt_33vAvfMcE12T1KC4AHqw5AMG4lkRQAxmhLmbMzl4oDoBPCo_xjfuzLjtzHYJ_VSZ_bIS70ELMZcmKG3WmQoyHTJsreJiakweculVDThQj-FM1SCIqmn7hfzmnuzi7jFEgghHbkY9IQo21ExWRBsXAtoamfGcTNefTw1g6H9CljnNqo0X0YVJLDeQwO7cqv1RLr5v0Dwiv9tdiJxcVXrozmISfr7u3YsAVl1h8UsRr2Zh8Hdp9dTPEk7s4ML9pQ5B5jCsfzCLmt4y_ysKOHUbXDSfgmoVvBzif4ve0GAynjNwTXtsXcqSXijZOBrZOAXpmbVN31AIiyGkBkDn1zHHo9PJQ_xF--GuB0DYcG-y3GOYnbdxW33C2eqXn9XLOt9IfflGT1cBpMqtS70HVhbQqQ5I6dztlLV4hGsnKCwsGPxNEudAmT9-ZXk.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
      format: "openai-responses-v1",
    }, {
      type: "web_search_call",
      id: "ws_0a4f6695c27438a2016afcbb98f68887d19d4aec37e04f8214",
      status: "completed",
      action: [Object ...],
    }, {
      id: "rs_0a4f6695c27438a2016afcbb9aa7a887d1891754298f003a96",
      type: "reasoning",
      status: "completed",
      summary: [],
      encrypted_content: 
…[52278 chars clipped]…
mBUtdK1S8Kwl2QwTNAz5-Zmb81bcekDmBR1hn-668v2kyraR12ljDnDUXliG0D-NM-h8MQcv2fi2H9vYw6mP2KLyoBw-vTPPgqvKwkI76OtIKnhuK5RdOUXU2RgHlh3WpFzFjXavM75d9QgRMzFCqiB0JMcgnoI5GL28N6g3MPYIcBvs7Mzx0fSQ0l7jtvNnEnavzoYWVoh9m4UquOfNDsXAuMiuUHfGRGv4lFzX-dvYQSxErF6TUJpc6k7WGUHOdyHVcLyLxxwWGb6B7lLt0e5txs3-RTAQhQiQg5nXzn7sTVIf_psOGsD6kr_sRFKZqzH63sqTedBTZyDy2QHs2WhpAabTDmZnlaiAqD1kS0iM5kopivOltLCVrY8M202-ChNiPphIxBzxf2dYbJ-Y4FjQtRQmlKSLm1BGtrd9-zcfIhKawGf9hr5-oRXlYM_qbA-89asIplku7SNJ4rxDP_GI16v47a23_ZLp7I1Gj0X2jmQX6CWwT3u9S_3vuHE43VFBCAHT3iTbHMXXU6_kmzpvGbnQb1sT9Gt6JcZq4G3Q9gqX-8CcLkDa-Xarq8X2JvXQbR_HuKNtR0p8M0Ix5HA4B6yVTh3SegegB0tOgSoDvp49WS_3r74M1z0fGuf-TWMKBzzGxgyYoQX6PJP7NJQ_KvzB3-i51__KTwo_YJX7p07vJGGaEyMzhVSZ_DLK3QCyCE-7kJyvwYq2iBz2xlf3eJTEq6vjJ3ZRXRfso-dI4VZ6WVQOOxWW-r4bKQ6GEdC1Btau5G9Ch1VMiStyb7Xw0qAjxZffmkCmjXoz5Pa9nrPqV599TplOuldypaUBlLb2esUCnZ8G4qrc4ZlHO5Yjwa31O52QfD9WGf8gkGZLne7b4lbr9VcrP02SIeajE1xxgAmgBS7oP8Vcs_7CE0KcTX5xdm90caDIkC6vFpX6vZQkjAi4wCtA8hCpoUwtVYk85ywLdqJPoK7J-vkwSdElHwJZnucMrBte_bjQIDbgaRcJq3-04qR8x6nX_XiS199bNVJM82JdUzX92GTAaKTeaWqR7iI7zs7dEfr69GmiaDohokYIZ3u25__F_pmADlFXPsuE1L8vPzDBQZBeV11FlxRrzrx1jf_z1gj_ur5rBI18clCxRHhPbhFyUT4lyY9_azEjLiDNp1JgA2bxQpaW8FGkcMIvU3ajeAIhrSYsQEKqpMcmd8Gt2RdjIgsBVNMD8jhByeapCu-wyUZ6HEOgh0nfjC_Wr8kEnqVDWi9qHHhzcD3lltNuDN4XBbzl3ZC3327VzHsHrCZw7P4IVS2RHyMm5iqH-gmiWLBm9EPHZ86hicwber2YID5vgguwZH_46FUykHSAsDVB4aGqlgijEhHfCvQ-h4yBwFERXLN-Kb2FY5_Re2U2s-vN9U65-EPG0UzC8He3D2Rhs9YKc7bP0Kq_y6keOlPeXKsL52tMRGwqA-UHnSUIShyuEkdLODf4dvCwdovlP2ojgWISKLKps4rbdJn1DopIaMyhJkHp-SUN2G0qLSLJSvdzSPJ1_xDMRoHA4RoT7LyTvySSU2J-E4V1tGVCPcZx7okOXH8zbgSd_gjn0Z6JsfOst4vujRe1SwlUpI4HNRPHaRhZ_eRWBDs9j4AxPjklGg3bwlbXt_MUqlP9Ff1xkiAyqOjPZvnHxmnP1HPT0SkMP9TUP-BDC4fdIMHOpuq9MeTv7wr-g5p0mLst7ZqcEBejhF97ZBtCXFu971uggp_PjUM6O3J9hgF6rTTROaI-Mg_ZrBp02aFjzflAhj6Hr5MCqw79cp-YzcXOXZD_xYMWzjqKJTnBby5ZrcgsWG-09Y9RZRe5OHlkEhMTzcERUXzJfPB6ijURoYuzScQIRd3YElL9amDhDDB3hy_et52tyZSDjHDulNyIi621EwBf-M9XPZAt8F5Hdpj_vpYkZGrNdKvtSH4ioFwmCgknZhHYqNzrivgLNNZ7CB7qXsut3KBpH8obsv3oIF5pelyEFy8WyJePv1wUOmOmaUn-ycoSkOolTmZKNQ6rE9FrvCUe7d_CtNAFtHPF4FGvAFDeXk0mZwcsqXRbrb5YDKPK50XL-mPL-hHAcFd5hBjDDU-RX_pazz7_tEiMt-ABWDO-Kon4eduF1JpgEggziTpkvwZ_Mb0VpGTKfnLgKwvcmIsGFuDCeegSi0gZcdnfFGyVSTEqUrc2M6T2q_eBPutpJsNQGOYf_WkDkPg7gYJN3jWPDreltoGioF5XkzVi4z2Y3TJqt5GRA9zKQGXjICqkCWYbRRF53qXH55DACUUOI_xA8IYb3jfbPZBPd3S413Mtx7dLD1mQaxCtrBc4Zb3YGcktMhVTxQH5BFzIcPDoONRfv75NB3kNWEO5vdGpQIGkV_aqkw9XN8vlG6m9Piqbi-bYH6xtCuH6P2QoWBxJV6EaD539OFoo7AiJt2wqB1pC8R9AvnH2dZssFm6X6PItswj-5C9LjAvSSc8EHQEow-2GC39tMWtLi95FPklDzhWI5RjUqQyo1gQ5g87BfMT5Yi2.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
      format: "openai-responses-v1",
    }, {
      id: "msg_tmp_j5x8zhi9skb",
      type: "message",
      role: "assistant",
      status: "completed",
      content: [Array ...],
    }
  ],
  error: null,
  incomplete_details: null,
  access_programs: {
```

## Web Search in Conversation

Include web search in multi-turn conversations. Replayed assistant content uses `output_text`, while user content uses `input_text`:

```typescript title="TypeScript" expandable lines theme={null}
const response = await fetch('https://openrouter.ai/api/v1/responses', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/o3',
    input: [
      {
        type: 'message',
        role: 'user',
        content: [
          {
            type: 'input_text',
            text: 'What is the latest version of React?',
          },
        ],
      },
      {
        type: 'message',
        id: 'msg_1',
        status: 'in_progress',
        role: 'assistant',
        content: [
          {
            type: 'output_text',
            text: 'Let me search for the latest React version.',
            annotations: [],
          },
        ],
      },
      {
        type: 'message',
        role: 'user',
        content: [
          {
            type: 'input_text',
            text: 'Yes, please find the most recent information',
          },
        ],
      },
    ],
    plugins: [{ id: 'web', max_results: 2 }],
    max_output_tokens: 9000,
  }),
});

const result = await response.json();
console.log(result);
```

```python title="Python" expandable lines theme={null}
import requests

response = requests.post(
    'https://openrouter.ai/api/v1/responses',
    headers={
        'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'model': 'openai/o3',
        'input': [
            {
                'type': 'message',
                'role': 'user',
                'content': [
                    {
                        'type': 'input_text',
                        'text': 'What is the latest version of React?',
                    },
                ],
            },
            {
                'type': 'message',
                'id': 'msg_1',
                'status': 'in_progress',
                'role': 'assistant',
                'content': [
                    {
                        'type': 'output_text',
                        'text': 'Let me search for the latest React version.',
                        'annotations': [],
                    },
                ],
            },
            {
                'type': 'message',
                'role': 'user',
                'content': [
                    {
                        'type': 'input_text',
                        'text': 'Yes, please find the most recent information',
                    },
                ],
            },
        ],
        'plugins': [{'id': 'web', 'max_results': 2}],
        'max_output_tokens': 9000,
    }
)

result = response.json()
print(result)
```

```go title="Go" lines theme={null}
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"model": "openai/o3",
		"input": []map[string]any{
			{
				"type": "message",
				"role": "user",
				"content": []map[string]any{
					{"type": "input_text", "text": "What is the latest version of React?"},
				},
			},
			{
				"type":   "message",
				"id":     "msg_1",
				"status": "in_progress",
				"role":   "assistant",
				"content": []map[string]any{
					{"type": "output_text", "text": "Let me search for the latest React version.", "annotations": []any{}},
				},
			},
			{
				"type": "message",
				"role": "user",
				"content": []map[string]any{
					{"type": "input_text", "text": "Yes, please find the most recent information"},
				},
			},
		},
		"plugins":           []map[string]any{{"id": "web", "max_results": 2}},
		"max_output_tokens": 9000,
	})

	req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	result, _ := io.ReadAll(resp.Body)
	fmt.Println(string(result))
}

```

```bash title="cURL" lines theme={null}
curl -X POST https://openrouter.ai/api/v1/responses \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/o3",
    "input": [
      {
        "type": "message",
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "What is the latest version of React?"
          }
        ]
      },
      {
        "type": "message",
        "id": "msg_1",
        "status": "in_progress",
        "role": "assistant",
        "content": [
          {
            "type": "output_text",
            "text": "Let me search for the latest React version.",
            "annotations": []
          }
        ]
      },
      {
        "type": "message",
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "Yes, please find the most recent information"
          }
        ]
      }
    ],
    "plugins": [{"id": "web", "max_results": 2}],
    "max_output_tokens": 9000
  }'
```

```text title="Output" theme={null}
{
  id: "gen-1794948148-iAySxfqJ04whz8P6t7vu",
  object: "response",
  created_at: 1794948148,
  model: "openai/o3",
  status: "completed",
  completed_at: 1794948163,
  output: [
    {
      id: "rs_065b3fc0ae66a3e3016afcbc358cd887d19d4b16c5423b5721",
      type: "reasoning",
      status: "completed",
      summary: [],
      encrypted_content: "gAAAAABq_Lw2o4DToqfotGlEOjd5IhhAsYZxEhfeaOHikXNTyRN-W4xTZBfdTDmUDNFDy1cS3bsHh3QcguoY8N1x90Q_nuu-XW50QYQc_PVAVBQ9Vu_aH7Yjxw3G7MhoRs8LYXvpRwoPVdmEEiF9uqGoOrDXk_keq7Rff7jfJpTRvSW8cNnhHZpfVHHVK0qNsaQzj98DxJD5Rg9oK5BiodnfnBZNUHhbY79xIWFH_7ZHOSj_J_A_gW4iElZFeYSB6HQcjLUspic9I0MERqf-5tN5PKhcKiMRfI0pXorFcOYx2txmob4jbEkjzIuAxsD5cokQpVQvtAnJf1ito9rkYyAoY2DPijz3C1a-AKSjM345R2ui14WjW1K7Ply3lLVq1egEV3Bo1wOfqktxqLQmctVZ3gx72fBpWDrWHKBy9kxTO0o936cwUEq4kBWb5YM3VSzVf47UE3ls7tNBIV0Eh6QeiHRDcswJ4FuVygNbmoWjU4LyZ6ik3O75AoTO4Kak4tHcEyGDQf3BEvk5ItZWbyNmnuiD7rgkmABYs1kpDaxs0M2YbmEHl3wgpyRJejmlJ26BwnCCl-hA5DPK61lsv4dgZUaNCAu9UyerBlos_C7l7ZwFslVeORfDJstMM1nVuWtvhb_ye97pwDyA3tR4-8FqdVca-TA7LE6fgDB8Teplb5xvI-CZe_BsDqCPtuTpYhDCBMlqC3RIl77LS8xXIDvBy0ICL3C3AZXP5JRZpFfGYAd6IrwpBpdMoWATkeA_OPFaAA4dO6wxvJRVQwaYfxkHzoEGioP9TwspGTSxtMqfBITDeeHBeRqVSDV4zKtb9ldKsn19QyQe-v4Q8kkDU2fDxhTDsX__WpafGXnBsSOWSfgA_3STVF5gGYffI251hWuKuHwhQoBiMveS4Qx2Mdb4-gGT37Qks4X7zNdJlupDWsyVd96fJp_8w4WZo0zlp7HEsCHY92844M6WElarXNoWbUvSJwB4KduMbeuczjSCewFvBi9UkNEve_DRCAgMHbpV69_aPBSzxZBIja7KqmM0eGUhPj_awa0qUperEBGCvqeWX0raiUdV-O9fIO7hrzG7u6Rq-r-N9SfEFo1kKNd8pA8-iMURdqTzg6rfGburc1xUwFKDsr2GNGA9Tsak0hfJzI_UaVSruSC7k1Tb5K3fqC5Gg3kQcSQ7yNudgWX7lIn5p7iFgSq_U1VWjTr69R1jOk6zFEpoYU9yAV8gB5UCDJl1F6kJfIi5P524cxyPqfyfkwNV9OvS2g9IWy3znICU17eTcXlNmAqR37BiGUHFk_xLKJOV35zlXgNb2TgukBLzY1fTlewFIrLfKOD0VR2wjDoEgUjhJtLek7ab7z-WzRFVnoa4GhWTly-dkN2uZ0WmhiOOeYeJwL3QpQZE_sqMMdYarhKwXcbAhAy8-TRC1UcOL4wWRtSS8jxinxdvoktsJs25PbnDiD7ROC9pKYF5lNI9CE3b6IGF-NHN8SmCDIgbPOLUyr-hFQSvO9510OiV1FDvDGgj3aWeZq5HQ7KhMtdnmKGd0AIbmXIMXxfUwRk8XL0ZfV5gEWxRQxQBtBx_pi7CBv_yfLxDG2jWjBiuuL64PwcbBLLJ18k7o1yBIoLyDUNSa-wGYDRCLIl86djwQy7RugHxzP8t9F77y5LQZxyehKKaOeiv4MzeTuQ1q41THpITrkuNQAkdWA_-rSod4kcDTIE6EpJhSqV_abK5B9bsU5zEihsyAJnzNl0q73El7Cclh-9x92aIzZILWpsMRpkb54qheKcUW0ZVwE8drpfbu78riZEaS0ouacFTI8JKRp7cZBej7zegbkiVLomcEfs81sY3c4-w3e0GbymPBEVrmresEtytjMmV9XIVRyzNCyQkw6IkWMKxZB0gL2tXzarGYWXBzDjzIy84LnGaltjCyaVzdvtQZoY7bkSOK9gAP4NrXdeCNeqFekY13UPP_GydvruyTrx38ct1Vphpkjh4GtAIlIM9jgmzDNwGXcciif8NV-U3HLXZFGRHVvbzoHovXJ5M59yl07F_LpxSQE1BHO1kljpYY1Qc4gRAQnYEk7RwJwX_g2shrJJos__BwRcPMDMI-ER_sz2jYCNedfxQeGjY76K642-pepg9MSuIAJNudPTLay7yK-qlCaKWapmdKD0AtuAo3f8hKPO6oiCGV19E.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
      format: "openai-responses-v1",
    }, {
      type: "web_search_call",
      id: "ws_065b3fc0ae66a3e3016afcbc360b7887d190cf9eeb9f3f07cd",
      status: "completed",
      action: [Object ...],
    }, {
      id: "rs_065b3fc0ae66a3e3016afcbc37091887d1a220d1686901d879",
      type: "reasoning",
      status: "completed",
      summary: [],
      encrypted_content: "gAAAAABq_Lw3SJzymmIdxfnRF3unoXllpEpA-BqKeIVBMmfur6o58fWzLv1YgPif9UAM_Loc8RicKG9iioPAse-ePdhtF6l-L2mLUyJibiJ17kc1JJ_-RHhj9bxmQBZ_FidVv53scEpt3p4BqOyelXB2yxnajU8zOb_DrIlJNGiSSFkAqVoxd8GcDU7hLCXw2Sk3mmdy1JUPiqsFFse-ZZVnOsxzSdEDiPI_rhBDTZbfoyU_LtYTIKwjtPaTmWxwbC7V3BpdncZTOftolFeJhTA47hfXCK_eWbGWnSpg6Dzs-844n_yIuYWkG06tqO9Wm-1fT2asAUITyprOe1GTs6HL-8iymcFn0oZx2rvQ6K-wSI-CLEL5vog4g1nXwrKx9NFc1L7A0YVHXl2F3x2dTlIivhm8_4JjQeMTCWOzJvOEdbqWI7wu0ZEvncofcoePYdL-BUWVfQBu-WiAbZU9ahCV-eF4W72HO3vsxoYwClKxZLLrL_9YTP-aeTSVM60QEB0NsluBqOL2sJMOVAFXTvtmAjU2eRf0GPmkdITVAMjQ5CdioBdKdHLBfOqwkrRDLwUSn1WiZrNrGCrK4sBPp8oSN1di6N9uud_o3nPfXVgrGdmb9F5cUsNhT_Mv1rWK9EXxcj8R_dUA1_TmVs910boIZatgXSrGiqtmvR-IFMXRbzGmW9cEvt_qYdZi-nCanNpxUrDoI68tBzEeBz08NZUJiOyz_Q3mPkBf1BAoZYht2L6_V6RaAEOSidbkLGCk1H8hv7U3eyv4RCDBJK1_H73bRmqZbtV-P4hPxWPfPWNGwz25gDF1kHfsbeM8F4zLW3VNfdMtYQtdk5Z6n5GXhweimcDFpmfi3JYbw_MdhbdsAXSCQsa-qnn7_tgFHaBvG1yXpAeOIYbj7A_MmdUVWW0nVUXdit6dK9yZbYcSaxbLb0udSt0EtUT1aUMp0HwfMjjhKCH4v00x8cFGqTLyx2K0QKtGuLKk-HmBluw4LSsm1pXMXDUB-cHQ660Kb0t
…[16715 chars clipped]…
ILAIQQ-NWnkPRNobqy9yrsK74C22dT0rWsPBG_f2F0cQQmKbEcd--4EjZXgUsgtUSCKyU8G_TKeFWA58yv2Gtmp-58husazvzd1LRP6FUnz_HV_Li6cFahoORBGIc3PcXh4loezW32ZqJVKWv7ednzcOoFmLX8LRI52yNkmLnuTUvDH9KMWMDThvUK75bVNbkn1aOdLBthb26AyBI2Drx2AEVT4fw331ixPw9DNPgSe0YVQqf5MhuvqlI_PBvGecR38SEIATQPpwvFhSVlRUEDlJo6N9w9NPE5v2A5OE5PtM_y_WSgiIUydVXVV9VPOHDnEQ4vmiiflIceVCXDYhRJtCAm7NVlt4cRZ27nMUK6CWyFVd1sUBv1FRcXN_bj2RGYT8bmHZ2KAgVNmk2BW3XF_go28_1A-hDoLDe42QUpPP10hWDgpr7TT5Ov2iAKgVVLOSHEY6-SJHRAWAPeqh30hBh-tPbTeZoWJ8jV8ri5ny_0oN1-oUWK4_rq9odowZKwY3Fc2jbfrSArGJRGWjvnoXSgjor6T5dPYkk7TgBfTwuUhdwzDV_QjDBmCfAbUrsj6QmFQ38F2D-zqJPZzDdFqJKceCDoysnMSyC5-B0Ovio-UmBGpRKEtrLjBP01dlGaZGJAVqG02avjcbBNyC3ep_NrJ4ERzXaQV3OCXjZ32rwiUsUSmQmrcnOZ29szyuDClakMLqxVOa07uzjU4qRH96wA04JwHZCsYeC47GRGHEC28Op-aIARHV_ia-BiSyZG65Os_kKUmCez3lLFIcWl0wh-Xt306MEXnoSQPBZlaRvurtARXCzG5yEQ5x7oZB1CxYbiYtnGRjyUadZFYyRe_V3wp4SuInomwFLGb6pJ4_YAAXftZ4RPtj0mXIsWTsqtZOA2VoV5R1bj9uhHJLat2t5ZPO0tBMoi3ACPb_QWRp0Hp8C4axNS0kwKh6Jxr5ev-E8HppFTE9XmhQtfS9kWpI3FezZt9FdNnR89VO3QrDc2kCPBa8nMv2uR9v9XInPFYYpd3H15LdP5t4VZMZyOfqu9AavvqUxSitxW0On67KF2XKuKGJBUne80P6hQpDmAMJXF09iT0tlHfcPhmxfb2PORotw0YIUJLtSpoPNTG5h06_YjkYdJZaWVkxlDk1DXRNUaGibbmCPUEPQYp7X8xzfaiiBF_HdTRIzf4mvtEqFqrEoCoH7HF6VXEEmRWL6ZqkB6eRXytH0qQ-rzW2ny9YzVSq_4nb_xG5vsjnedr8l2pYsCjuL09HE81C5-Z6Ru0VBadeMg2Mj7NNvxfp8D5NKUC12n8K42bTJ1iNL-49EppMudwr7eKBwLRFQLEFbTZIo8DePWBdFGnvXwyDfxHvJuDzS1Chr8qLjpIOLJEg1K69WiXxsbZWvoodEEfZQtvvnktxsXSRR9l-3r4uV-JWWY5MXl64fwDXZxPzsZgrKHs0MXmGTPnI1vy4TAYwXdE_tZKkumN1_oItNeYeSYO6nq3xrxEiNmqpO_dc7A7jgdjbux63WFQ5OG-_VnahydX05NTQZScyu7ohG_10bBq5-6BR5N6w-d3Fowd2G3_3oWXM0Y-X3716lniwYxr8k8bm-C_hd98IE8sEYs9SGnFMEzWcUP76yBYIEV5FfiVStbQ99Di1Q37xb5--s-kdGc1AbznUs19cabzBAgtJuO4udVgLgLfwkF0WZlFlZ_Bez3ooVkNlviRw9AZcC8RQaemMG1Du8wQcrt3fKNtn1IcZESWFoFJXvIhdeSKDb96pZG_bzzVyOx1ru5M-lUbf9QyoTMgmUQCyv4Ivid0J-MHSucDgwoHIMT9YkgByRIUCSS3paKH5JFkWNGmo73yG44LA9xoKBy2CEHIVR8rPZZfFxg0ITx3KX2jUp7s4NzJ9BA-5MfmwdkLdRpLrKT_6XQLqi846P61vXgqsHlHY9N2ixHJMg_MKqQvEtKNumAQItem4ofGcIPhZgmeL6Rq2iZrfUFJ-5LyfgHc3wettyXLaqQpKNNgjRw0_7XWAIaasceDsyb3LgR0UF5tI66D6vt7-btZ27yzH3fOqYIMQaD1nFpmD0wd5LjHkdpFJSCBAcvoYCxGUD0B4QFx9utAzMw5_aYk797jFeoV6uEQ1uVXux9A0qzcl_4fkAIDm-AADg7WI-ygxtGpjG79H1KZmVjuvNXKt4DyFZE-Q5MKj9FFr2jaKf3S_qFjEsrMI1No025jhJ3KFW8yqgwx9C1tXcDTPhl06ghG17mH3w2XkZSbFgfvaUaMrbPN5DlkYrxwtPlOsWBrK9DbGgk4k--lL6CgehPGGXO7p_Ls1wCMIVvaIVvC14KGhpp9ScSRsWFiOGkIU02TVh4e-HlXizMnWI2eg_BxTx_0inJgfwsUqNeSdbANmcYGR0I8jc5YdVU7u0oPPLolEex5FE3cmRquoSjFTxu-qJHIP3Qd1Be5kwb-fITjWEe0PKtDe_A7EptFmFQrgIcvw6T2xZUm0lCiwcgD3_ph7yHij_Tk2m9FLbyTdCkpekFTreXEHVHZY=.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
      format: "openai-responses-v1",
    }, {
      id: "msg_tmp_imowgllm5k",
      type: "message",
      role: "assistant",
      status: "completed",
      content: [Array ...],
    }
  ],
  error: null,
  incomplete_details: null,
  access_programs: {
```

## Streaming Web Search

Monitor web search progress with streaming:

```typescript title="TypeScript" expandable lines theme={null}
const response = await fetch('https://openrouter.ai/api/v1/responses', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.OPENROUTER_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/o3',
    input: [
      {
        type: 'message',
        role: 'user' as const,
        content: [
          {
            type: 'input_text',
            text: 'What is the latest news about AI?',
          },
        ],
      },
    ],
    plugins: [{ id: 'web', max_results: 2 }],
    stream: true,
    max_output_tokens: 9000,
  }),
});

const reader = response.body!.getReader();
const decoder = new TextDecoder();

stream: while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  const chunk = decoder.decode(value);
  const lines = chunk.split('\n');

  for (const line of lines) {
    if (line.startsWith('data: ')) {
      const data = line.slice(6);
      if (data === '[DONE]') break stream;

      try {
        const parsed = JSON.parse(data);
        if (parsed.type === 'response.output_item.added' &&
            parsed.item?.type === 'message') {
          console.log('Message added');
        }
        if (parsed.type === 'response.completed') {
          const annotations = parsed.response?.output
            ?.find(o => o.type === 'message')
            ?.content?.find(c => c.type === 'output_text')
            ?.annotations || [];
          console.log('Citations:', annotations.length);
        }
      } catch (e) {
        // Skip invalid JSON
      }
    }
  }
}
```

```python title="Python" expandable lines theme={null}
import requests
import json

response = requests.post(
    'https://openrouter.ai/api/v1/responses',
    headers={
        'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'model': 'openai/o3',
        'input': [
            {
                'type': 'message',
                'role': 'user',
                'content': [
                    {
                        'type': 'input_text',
                        'text': 'What is the latest news about AI?',
                    },
                ],
            },
        ],
        'plugins': [{'id': 'web', 'max_results': 2}],
        'stream': True,
        'max_output_tokens': 9000,
    },
    stream=True
)

for line in response.iter_lines():
    if line:
        line_str = line.decode('utf-8')
        if line_str.startswith('data: '):
            data = line_str[6:]
            if data == '[DONE]':
                break
            try:
                parsed = json.loads(data)
                if (parsed.get('type') == 'response.output_item.added' and
                    parsed.get('item', {}).get('type') == 'message'):
                    print('Message added')
                if parsed.get('type') == 'response.completed':
                    output = parsed.get('response', {}).get('output', [])
                    message = next((o for o in output if o.get('type') == 'message'), {})
                    content = message.get('content', [])
                    text_content = next((c for c in content if c.get('type') == 'output_text'), {})
                    annotations = text_content.get('annotations', [])
                    print(f'Citations: {len(annotations)}')
            except json.JSONDecodeError:
                continue
```

```go title="Go" lines theme={null}
package main

import (
	"bufio"
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
	"strings"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"model": "openai/o3",
		"input": []map[string]any{
			{
				"type": "message",
				"role": "user",
				"content": []map[string]any{
					{"type": "input_text", "text": "What is the latest news about AI?"},
				},
			},
		},
		"plugins":           []map[string]any{{"id": "web", "max_results": 2}},
		"stream":            true,
		"max_output_tokens": 9000,
	})

	req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	scanner := bufio.NewScanner(resp.Body)
	scanner.Buffer(make([]byte, 1024*1024), 16*1024*1024)
	for scanner.Scan() {
		line := scanner.Text()
		if !strings.HasPrefix(line, "data: ") {
			continue
		}
		data := strings.TrimPrefix(line, "data: ")
		if data == "[DONE]" {
			break
		}

		var parsed struct {
			Type string
			Item struct{ Type string }
			Response struct {
				Output []struct {
					Type    string
					Content []struct {
						Type        string
						Annotations []any
					}
				}
			}
		}
		if json.Unmarshal([]byte(data), &parsed) != nil {
			continue // Skip invalid JSON
		}

		if parsed.Type == "response.output_item.added" && parsed.Item.Type == "message" {
			fmt.Println("Message added")
		}
		if parsed.Type == "response.completed" {
			count := 0
		find:
			for _, o := range parsed.Response.Output {
				if o.Type == "message" {
					for _, c := range o.Content {
						if c.Type == "output_text" {
							count = len(c.Annotations)
							break
						}
					}
					break find
				}
			}
			fmt.Println("Citations:", count)
		}
	}
}

```

```bash title="cURL" lines theme={null}
curl -sN https://openrouter.ai/api/v1/responses \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/o3",
    "input": [
      {
        "type": "message",
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "What is the latest news about AI?"
          }
        ]
      }
    ],
    "plugins": [{"id": "web", "max_results": 2}],
    "stream": true,
    "max_output_tokens": 9000
  }' | sed -un 's/^data: //p' | jq -rR '
  fromjson? |
  if .type == "response.output_item.added" and .item.type == "message" then
    "Message added"
  elif .type == "response.completed" then
    "Citations: \(([.response.output[]? | select(.type == "message")
      | .content[]? | select(.type == "output_text") | .annotations][0] // []) | length)"
  else empty end'

```

```text title="Output" theme={null}
Message added
```

## Annotation Processing

Extract and process citation information:

```typescript title="TypeScript" lines theme={null}
function extractCitations(response: any) {
  const messageOutput = response.output?.find((o: any) => o.type === 'message');
  const textContent = messageOutput?.content?.find((c: any) => c.type === 'output_text');
  const annotations = textContent?.annotations || [];

  return annotations
    .filter((annotation: any) => annotation.type === 'url_citation')
    .map((annotation: any) => ({
      url: annotation.url,
      text: textContent.text.slice(annotation.start_index, annotation.end_index),
      startIndex: annotation.start_index,
      endIndex: annotation.end_index,
    }));
}

const result = await response.json();
const citations = extractCitations(result);
console.log('Found citations:', citations);
```

```python title="Python" expandable lines theme={null}
def extract_citations(response_data):
    output = response_data.get('output', [])
    message_output = next((o for o in output if o.get('type') == 'message'), {})
    content = message_output.get('content', [])
    text_content = next((c for c in content if c.get('type') == 'output_text'), {})
    annotations = text_content.get('annotations', [])
    text = text_content.get('text', '')

    citations = []
    for annotation in annotations:
        if annotation.get('type') == 'url_citation':
            citations.append({
                'url': annotation.get('url'),
                'text': text[annotation.get('start_index', 0):annotation.get('end_index', 0)],
                'start_index': annotation.get('start_index'),
                'end_index': annotation.get('end_index'),
            })

    return citations

result = response.json()
citations = extract_citations(result)
print(f'Found citations: {citations}')
```

```go title="Go" lines theme={null}
type Annotation struct {
	Type       string
	URL        string
	StartIndex int `json:"start_index"`
	EndIndex   int `json:"end_index"`
}
type Response struct {
	Output []struct {
		Type    string
		Content []struct {
			Type        string
			Text        string
			Annotations []Annotation
		}
	}
}
type Citation struct {
	URL        string `json:"url"`
	Text       string `json:"text"`
	StartIndex int    `json:"startIndex"`
	EndIndex   int    `json:"endIndex"`
}

extractCitations := func(response Response) []Citation {
	citations := []Citation{}
	for _, o := range response.Output {
		if o.Type != "message" {
			continue
		}
		for _, c := range o.Content {
			if c.Type != "output_text" {
				continue
			}
			text := []rune(c.Text)
			for _, a := range c.Annotations {
				if a.Type != "url_citation" || a.StartIndex < 0 || a.EndIndex > len(text) || a.StartIndex > a.EndIndex {
					continue
				}
				citations = append(citations, Citation{
					URL:        a.URL,
					Text:       string(text[a.StartIndex:a.EndIndex]),
					StartIndex: a.StartIndex,
					EndIndex:   a.EndIndex,
				})
			}
			return citations
		}
		return citations
	}
	return citations
}

var result Response
if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
	panic(err)
}
citations := extractCitations(result)
out, _ := json.MarshalIndent(citations, "", "  ")
fmt.Println("Found citations:", string(out))
```

```bash title="cURL" lines theme={null}
RESPONSE=$(curl -s -X POST https://openrouter.ai/api/v1/responses \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/o3",
    "input": "What is OpenRouter?",
    "plugins": [{"id": "web", "max_results": 3}],
    "max_output_tokens": 9000
  }')

echo "$RESPONSE" | jq -r '
  [.output[]? | select(.type == "message") | .content[]? | select(.type == "output_text")][0] as $t
  | "Found citations:",
    [($t.annotations // [])[] | select(.type == "url_citation") | {
      url,
      text: $t.text[.start_index:.end_index],
      startIndex: .start_index,
      endIndex: .end_index
    }]'
```

## Best Practices

1. **Limit results**: Use appropriate `max_results` to balance quality and speed
2. **Handle annotations**: Process citation annotations for proper attribution
3. **Query specificity**: Make search queries specific for better results
4. **Error handling**: Handle cases where web search might fail
5. **Rate limits**: Be mindful of search rate limits

## Next Steps

* Learn about [Tool Calling](https://openrouter.ai/docs/api_reference/responses/tool-calling.md) integration
* Explore [Reasoning](https://openrouter.ai/docs/api_reference/responses/reasoning.md) capabilities
* Review [Basic Usage](https://openrouter.ai/docs/api_reference/responses/basic-usage.md) fundamentals
