> For clean Markdown of any page, append `.md` to the page URL.
> Documentation index: https://you.com/docs/llms.txt (section indexes: append `/llms.txt` to any section URL).
> Search these docs: Docs MCP at https://you.com/docs/_mcp/server (`searchDocs`, no API key).
> Call live You.com APIs: Product MCP at https://api.you.com/mcp (keyless `?profile=free` exposes `you-search` and `you-discover`. Research and finance use `/mcp/research`, `/mcp/finance`, or `?tools=` on `/mcp`). To pick an API or integration path, call `you-discover` on that server instead of guessing.
> OpenAPI: https://you.com/docs/openapi.json—auth header `X-API-Key`, env `YDC_API_KEY`.

## Highlight Token Budget for POST /v1/search

`extraction_mode: "highlights"` now accepts an optional `highlights` object with `total_max_tokens`, a cap on the number of highlight tokens across the whole response. It takes values from 1024 to 8192. Omit it and the default budget of 8192 applies, so existing requests are unaffected.

A 10-result highlights response is roughly 6,000–7,500 tokens by default. With `total_max_tokens: 1024` it drops to under 1,000, which suits agents that call search in a tight loop. The budget is shared by every result, so pair it with a lower `count` when you want fewer, longer results.

Read the Retrieve Page Content guide