> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nativeport.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nativeport.ai/_mcp/server.

# You.com

Fronts the Search API of [You.com](https://you.com); the gateway supplies You.com's `/v1` base itself:

```
GET /youcom/search   → https://ydc-index.io/v1/search
```

Only `GET` is mounted. Controls such as `query`, `count`, and `livecrawl` ride in the query string, which is relayed to You.com without modification.

The Contents and Research APIs on You.com's side are **intentionally left unexposed**; the Search API is the only part proxied.

## Credential handling

* **`X-API-Key` is injected**; a client-supplied value is overwritten.
* **`Authorization` is dropped** before the request goes upstream — your gateway token is meaningless to You.com.

## Example

```bash
curl "$GATEWAY/youcom/search?query=cloudflare+workers" \
  -H "Authorization: Bearer $TOKEN"
```

Responses arrive as You.com's JSON, untouched. Field-level request and response detail lives in [You.com's documentation](https://you.com/docs); the gateway modifies neither.