> 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`.

## Extraction Source for POST /v1/search

The `extraction` object on `POST /v1/search` now accepts an `extraction_source` field that controls where full page content comes from:

* **`blend`** serves cached content when it is available and crawls the page live when it is not. This is the default, so existing requests are unaffected.
* **`cache`** returns cached content only. It is the fastest of the three because it never waits on a crawl, and results with nothing cached come back without a `contents` object.
* **`fetch`** always crawls the page live, which returns the freshest content at higher latency.

`extraction_source` applies to `extraction_mode: "full_page"` and is ignored for `"highlights"`. It is available on `POST /v1/search` only.

Only pages crawled live are billed, at \$1.00 per 1,000 pages. Cached content carries no extraction charge, so `cache` costs nothing beyond the base call price and `blend` bills only the pages it crawls live.

Read the page content guide