Get live news
Retrieve real-time news results from the You.com Web Search API. Filter by recency, country, language, and more.
Add You.com to your agent or IDE via MCP — every API in these docs is available on https://api.you.com/mcp (new accounts get $100 in free credits), and Search is free to try via https://api.you.com/mcp?profile=free, no signup required. MCP Server guide →
Overview
The Web Search API automatically returns news articles alongside web results whenever your query has news intent — breaking events, recent announcements, trending topics. You don’t need a separate endpoint or special configuration: just send your query and our classification system determines if news results are relevant.
When news results are returned, they appear in the results.news array alongside results.web.
News-Specific Fields
Each news result includes:
Parameters That Improve News Results
These parameters tune your news queries for relevance, recency, and safety:
freshness — control recency
freshness is the most important parameter for news use cases. Breaking news requires day; trend analysis might use week or month. You can also specify an exact date range.
Basic News Query
Filter by Country and Language
Use country and language together to narrow results to a specific region and language. This is useful for monitoring local news, international media, or non-English markets.
Custom Date Range
Use a date range string in YYYY-MM-DDtoYYYY-MM-DD format to target a specific window — useful for historical monitoring or scheduled digests.
Get Full Article Content
Set extraction.extraction_mode to full_page on a POST /v1/search request to retrieve the full page content of every search result, web and news alike.
Set extraction.full_page.extraction_formats to ["markdown"] or ["html"] based on your needs. Use ["markdown"] for LLM-ready output.
Full page extraction is billed at $1.00 per 1,000 pages on top of the base Web Search API rate — the same price as the Contents API. Each article body fetched counts as one page.
For news monitoring pipelines that need full article bodies, combine extraction_mode: "full_page" with freshness=day and schedule recurring calls. See Retrieve page content for more on full page extraction.