v2.3.0

What's New in 2.3.0

Research API

New standalone Research endpoint for in-depth, multi-step research queries with citations and sources. Supports four effort levels: lite, standard, deep, and exhaustive.

res = you.research(
    input="Compare global approaches to AI regulation",
    research_effort=ResearchEffort.DEEP,
)
print(res.output.content)       # markdown with inline citations
print(res.output.sources)       # list of Source objects

Breaking Changes

• Python >= 3.10 now required (was >= 3.9.2)
• Search API: count now defaults to 10 (was None)
• Contents API: crawl_timeout type changed from float to int

See MIGRATION.md for upgrade instructions.

Other Changes

• Added CI test workflow (Python 3.10 + 3.12) with mock server
• Removed pre-compiled mock server binary from git
• Fixed missing imports in README streaming example
• Fixed run_time_ms unit label in README ("seconds" -> "ms")

Full Changelog: https://github.com/youdotcom-oss/youdotcom-python-sdk/blob/main/CHANGELOG.md

v2.2.0

What's Changed

• Python SDK 2.2.0 by @tyler5673 in #6

Full Changelog: v2.1.0...v2.2.0

v2.1.0

See https://github.com/youdotcom-oss/youdotcom-python-sdk/blob/main/CHANGELOG.md#200---2026-01-09

What's Changed

• Add performance testing framework by @tyler5673 in #3
• DX-94 Unified API Spec for Agents by @kevmalek in #4
• Release/2.0.0 by @tyler5673 in #5

Full Changelog: v1.4.1...v2.1.0

v1.4.1

• Adds support for contents in v1/search web results (see docs) when livecrawl is enabled

v1.4.0

• Added metadata to the contents API response
• Added support for the language query parameter to v1 search request
• request_uuid has been renamed to search_uuid in GetV1SearchMetadata

v1.3.0

Bumping version code to 1.3.0 for PyPi compatibility

v1.0.0

Initial release version of the You.com Python SDK