> 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 Parameter for POST /v1/search

`POST /v1/search` now accepts an `extraction` object that controls what text comes back with each result. Two modes are available:

* **`extraction_mode: "highlights"`** returns `contents.highlights`—the passages from each page most relevant to your query, sized for token-sensitive agentic workflows. Snippets are omitted.
* **`extraction_mode: "full_page"`** returns `contents.markdown` or `contents.html` carrying the full page, alongside the default snippets.

The `extraction` parameter is available on `POST /v1/search` only. `GET /v1/search` continues to support `livecrawl` for full page content. Set `extraction.full_page.extraction_formats` to `["markdown"]`, `["html"]`, or both.

Full page extraction is billed at \$1.00 per 1,000 pages on top of the base Web Search API rate.

Read the Web Search API overview