Deep Search
Multi-pass query expansion that surfaces sources a single search would miss.
A single search returns the obvious results. Deep Search goes further: it reformulates your query into several sub-questions, crawls iteratively, and consolidates the findings into a ranked, deduplicated source set. Use it when one query won’t surface everything—broad topics, comparisons, and “find me everything about X” research.
On the You.com platform, deep, multi-pass retrieval is exposed through the Research API at higher effort levels. The agent expands the query, runs multiple search passes, reads pages, and ranks the consolidated sources for you.
What You’ll Build
A script that takes one broad question and gets back a synthesized answer drawn from many search passes—with the sources grouped and cited. You control depth with research_effort: step it up to deep or exhaustive for the widest source net.
Try It Live
Run a real Research API request right here—no setup. Open the Try It panel below, paste your API key, set research_effort to deep, and send it against the live endpoint.
Prerequisites
Install 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, or the hosted server at https://api.you.com/mcp, when an agent should call the tools. Use the Python SDK when you want a typed client that tracks new API fields. The @youdotcom-oss/sdk package is deprecated.
Walkthrough
Python
TypeScript
Effort Levels
A synchronous request holds the connection for the full run. Set your HTTP client timeout above the tier’s upper bound—longer than 120s for deep and 300s for exhaustive—or send background: true and collect the result with background requests.