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
Walkthrough
Python
TypeScript
Effort Levels
For deep or exhaustive requests that may exceed your client or server timeout, use background mode to queue the task and poll or stream for the result. The frontier effort level requires background mode.
Next Steps
The full walkthrough of the Research API, effort levels, and response format.
Fast, single-pass web results when you don’t need synthesis.
All parameters and response fields.