diff --git a/docs/my-website/docs/completion/web_search.md b/docs/my-website/docs/completion/web_search.md
index e9aebc96ed7..7a67dc265e4 100644
--- a/docs/my-website/docs/completion/web_search.md
+++ b/docs/my-website/docs/completion/web_search.md
@@ -12,7 +12,10 @@ Use web search with litellm
| LiteLLM Cost Tracking | ✅ Supported |
| LiteLLM Version | `v1.63.15-nightly` or higher |
-## Quick Start
+
+## `/chat/completions` (litellm.completion)
+
+### Quick Start
@@ -73,7 +76,7 @@ response = client.chat.completions.create(
-## Search context size
+### Search context size
@@ -124,6 +127,127 @@ response = client.chat.completions.create(
+## `/responses` (litellm.responses)
+
+### Quick Start
+
+
+
+
+```python showLineNumbers
+from litellm import responses
+
+response = responses(
+ model="openai/gpt-4o",
+ input=[
+ {
+ "role": "user",
+ "content": "What was a positive news story from today?"
+ }
+ ],
+ tools=[{
+ "type": "web_search_preview" # enables web search with default medium context size
+ }]
+)
+```
+
+
+
+1. Setup config.yaml
+
+```yaml
+model_list:
+ - model_name: gpt-4o
+ litellm_params:
+ model: openai/gpt-4o
+ api_key: os.environ/OPENAI_API_KEY
+```
+
+2. Start the proxy
+
+```bash
+litellm --config /path/to/config.yaml
+```
+
+3. Test it!
+
+```python showLineNumbers
+from openai import OpenAI
+
+# Point to your proxy server
+client = OpenAI(
+ api_key="sk-1234",
+ base_url="http://0.0.0.0:4000"
+)
+
+response = client.responses.create(
+ model="gpt-4o",
+ tools=[{
+ "type": "web_search_preview"
+ }],
+ input="What was a positive news story from today?",
+)
+
+print(response.output_text)
+```
+
+
+
+### Search context size
+
+
+
+
+```python showLineNumbers
+from litellm import responses
+
+# Customize search context size
+response = responses(
+ model="openai/gpt-4o",
+ input=[
+ {
+ "role": "user",
+ "content": "What was a positive news story from today?"
+ }
+ ],
+ tools=[{
+ "type": "web_search_preview",
+ "search_context_size": "low" # Options: "low", "medium" (default), "high"
+ }]
+)
+```
+
+
+
+```python showLineNumbers
+from openai import OpenAI
+
+# Point to your proxy server
+client = OpenAI(
+ api_key="sk-1234",
+ base_url="http://0.0.0.0:4000"
+)
+
+# Customize search context size
+response = client.responses.create(
+ model="gpt-4o",
+ tools=[{
+ "type": "web_search_preview",
+ "search_context_size": "low" # Options: "low", "medium" (default), "high"
+ }],
+ input="What was a positive news story from today?",
+)
+
+print(response.output_text)
+```
+
+
+
+
+
+
+
+
## Checking if a model supports web search