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

# Python SDK

The Python SDK is the official client for the Web Search, Answer, Contents, Research, and Finance Research APIs. It is published on [PyPI](https://pypi.org/project/youdotcom/) and tracks new API fields as they ship.

```bash
pip install youdotcom
```

The client reads `YDC_API_KEY` from the environment.

> **TypeScript, MCP, or the Python SDK**
>
> TypeScript and JavaScript have three paths. Use `fetch` against the REST APIs when the application needs the JSON. Use [`@youdotcom-oss/mcp`](https://www.npmjs.com/package/@youdotcom-oss/mcp), or the hosted server at `https://api.you.com/mcp`, when an agent should call the tools. Use the [Python SDK](/docs/integrations/python-sdk) when you want a typed client that tracks new API fields. The `@youdotcom-oss/sdk` package is deprecated.

Every API guide includes a Python sample next to the request. Open the quickstart for the API you are calling:

* [Web Search API](/docs/guides/search/quickstart)
* [Answer API](/docs/guides/answer/quickstart)
* [Contents API](/docs/guides/contents/quickstart)
* [Research API](/docs/guides/research/quickstart)
* [Finance Research API](/docs/guides/finance-research/quickstart)

Background research helpers live on [Background Requests](/docs/guides/research/background-requests). Source, model docs, and release history are on [GitHub](https://github.com/youdotcom-oss/youdotcom-python-sdk/).