docs(search): add You.com provider page

docs/search/index.md

@@ -2,7 +2,7 @@
 
 | Feature | Supported | 
 |---------|-----------|
-| Supported Providers | `perplexity`, `tavily`, `parallel_ai`, `exa_ai`, `brave`, `google_pse`, `dataforseo`, `firecrawl`, `searxng`, `linkup`, `duckduckgo`, `searchapi`, `serper` |
+| Supported Providers | `perplexity`, `tavily`, `parallel_ai`, `exa_ai`, `brave`, `google_pse`, `dataforseo`, `firecrawl`, `searxng`, `linkup`, `duckduckgo`, `searchapi`, `serper`, `you_com` |
 | Cost Tracking | ✅ |
 | Logging | ✅ |
 | Load Balancing | ❌ |
@@ -210,7 +210,7 @@ See the [official Perplexity Search documentation](https://docs.perplexity.ai/ap
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `query` | string or array | Yes | Search query. Can be a single string or array of strings |
-| `search_provider` | string | Yes (SDK) | The search provider to use: `"perplexity"`, `"tavily"`, `"parallel_ai"`, `"exa_ai"`, `"brave"`, `"google_pse"`, `"dataforseo"`, `"firecrawl"`, `"searxng"`, `"linkup"`, `"duckduckgo"`, `"searchapi"`, or `"serper"` |
+| `search_provider` | string | Yes (SDK) | The search provider to use: `"perplexity"`, `"tavily"`, `"parallel_ai"`, `"exa_ai"`, `"brave"`, `"google_pse"`, `"dataforseo"`, `"firecrawl"`, `"searxng"`, `"linkup"`, `"duckduckgo"`, `"searchapi"`, `"serper"`, or `"you_com"` |
 | `search_tool_name` | string | Yes (Proxy) | Name of the search tool configured in `config.yaml` |
 | `max_results` | integer | No | Maximum number of results to return (1-20). Default: 10 |
 | `search_domain_filter` | array | No | List of domains to filter results (max 20 domains) |
@@ -279,6 +279,7 @@ The response follows Perplexity's search format with the following structure:
 | Serper | `SERPER_API_KEY` | `serper` |
 | DuckDuckGo | `DUCKDUCKGO_API_BASE` | `duckduckgo` |
 | SearchAPI.io | `SEARCHAPI_API_KEY` | `searchapi` |
+| You.com | `YOUCOM_API_KEY` *(optional — omit for keyless free tier)* | `you_com` |
 
 See the individual provider documentation for detailed setup instructions and provider-specific parameters.
 

docs/search/you_com.md

@@ -0,0 +1,132 @@
+# You.com Search
+
+**Get API Key (optional, for higher rate limits):** [https://you.com/docs](https://you.com/docs)
+
+You.com offers two tiers:
+
+| Mode | Endpoint | Auth | Limits |
+|---|---|---|---|
+| **Keyless free tier** (default) | `https://api.you.com/v1/agents/search` | none | IP-throttled, ~100 queries/day |
+| **Keyed tier** | `https://ydc-index.io/v1/search` | `X-API-Key` | higher rate limits |
+
+If `YOUCOM_API_KEY` is not set, the adapter automatically uses the keyless endpoint — no signup required to start.
+
+## LiteLLM Python SDK
+
+### Keyless (zero config)
+
+```python showLineNumbers title="You.com Search - keyless"
+from litellm import search
+
+response = search(
+    query="latest AI developments",
+    search_provider="you_com",
+    max_results=5
+)
+
+for result in response.results:
+    print(f"{result.title}: {result.url}")
+    print(f"Snippet: {result.snippet}\n")
+```
+
+### With API key (higher limits)
+
+```python showLineNumbers title="You.com Search - keyed"
+import os
+from litellm import search
+
+os.environ["YOUCOM_API_KEY"] = "sk-..."
+
+response = search(
+    query="latest AI developments",
+    search_provider="you_com",
+    max_results=5
+)
+```
+
+## LiteLLM AI Gateway
+
+### 1. Setup config.yaml
+
+```yaml showLineNumbers title="config.yaml"
+model_list:
+  - model_name: gpt-4
+    litellm_params:
+      model: gpt-4
+      api_key: os.environ/OPENAI_API_KEY
+
+search_tools:
+  - search_tool_name: you-com-search
+    litellm_params:
+      search_provider: you_com
+      # api_key optional - omit to use the keyless free tier
+      api_key: os.environ/YOUCOM_API_KEY
+```
+
+### 2. Start the proxy
+
+```bash
+litellm --config /path/to/config.yaml
+
+# RUNNING on http://0.0.0.0:4000
+```
+
+### 3. Test the search endpoint
+
+```bash showLineNumbers title="Test Request"
+curl http://0.0.0.0:4000/v1/search/you-com-search \
+  -H "Authorization: Bearer sk-1234" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "query": "latest AI developments",
+    "max_results": 5
+  }'
+```
+
+## Unified Parameters
+
+You.com supports the standard Perplexity unified spec parameters:
+
+```python showLineNumbers title="You.com Search with unified parameters"
+from litellm import search
+
+response = search(
+    query="machine learning research",
+    search_provider="you_com",
+    max_results=10,                              # -> count
+    search_domain_filter=["arxiv.org"],          # -> include_domains
+    country="US"                                 # -> country (lowercased)
+)
+```
+
+| Unified spec parameter | Mapped to You.com parameter |
+|---|---|
+| `max_results` | `count` |
+| `search_domain_filter` | `include_domains` |
+| `country` | `country` (lowercased) |
+| `max_tokens_per_page` | _ignored (no equivalent)_ |
+
+## Provider-specific Parameters
+
+You can pass any You.com-specific parameter as a keyword argument; unrecognized parameters are forwarded to the upstream request body:
+
+```python showLineNumbers title="You.com Search with provider-specific parameters"
+from litellm import search
+
+response = search(
+    query="AI breakthroughs",
+    search_provider="you_com",
+    # You.com-specific parameters (passed through verbatim)
+    freshness="week",                            # 'day', 'week', 'month', 'year', or date range
+    exclude_domains=["example.com"],
+    language="en"
+)
+```
+
+## Response Notes
+
+You.com's API returns results split into `web` and `news` arrays. The LiteLLM adapter flattens both into a single ordered `results` list (web first, then news) so the response matches the unified [`SearchResponse`](./index#response-format) shape.
+
+For each result:
+- `snippet` prefers the first entry of the upstream `snippets` array; falls back to `description`.
+- `date` is populated from upstream `page_age` (ISO 8601 datetime).

sidebars.js

@@ -795,6 +795,7 @@ const sidebars = {
             "search/searxng",
             "search/linkup",
             "search/serper",
+            "search/you_com",
           ]
         },
         "skills",