# CNN API: Search news > Searches CNN articles by keyword, with optional publication date range, sort order and pagination. Unofficial. Not affiliated with or endorsed by CNN. - Page: https://fous.com/methods/cnn.com/search-news - Method: `cnn.com/search_news`, version 1 - Website: cnn.com - Returns: headline, summary, published time, authors, section, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `page` | integer | no | | Results page, for example 2. Default 1. | | `sort` | string | no | | Order the articles by publication time or search relevance, for example newest. One of "newest", "most_relevant". Default "newest". | | `query` | string | yes | `"Tesla"` | Words to search CNN articles for, for example Tesla. | | `to_date` | string | no | | Latest publication date (YYYY-MM-DD), inclusive, for example 2026-09-28. | | `from_date` | string | no | | Earliest publication date (YYYY-MM-DD), inclusive, for example 2026-01-01. | | `max_results` | integer | no | | Maximum articles per page, for example 20. Default 20. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "query": "Tesla" } ``` Its output: ```json { "articles": [ { "link": "https://www.cnn.com/2026/09/03/business/tesla-robotaxi-cybercab-self-driving-cars", "authors": [ "Chris Isidore" ], "section": "business", "summary": "Nothing is more important to Tesla than its ambitious plan for self-driving “robotaxis.” But even as it hosts an event for its Cybercab service Thursday, it still has a long way to catch up to the competition in an industry where few have made any money at all.", "headline": "Tesla keeps hyping robotaxis as its future. But it’s trailing rival Waymo in a field yet to prove profitable", "published_at": "2026-09-03T11:00:29.258000+00:00" }, { "link": "https://www.cnn.com/business/tech/elon-musk-tesla-risk-takers", "authors": [ "Hadas Gold" ], "section": "business", "summary": "Tesla dominated the electric vehicle industry by the mid-2010s with sleek, fast cars that helped combat the public perception that EVs were severely limited by short ranges.", "headline": "Elon Musk is betting Tesla’s future isn’t about cars at all", "published_at": "2026-01-29T13:25:59.868000+00:00" }, { "link": "https://www.cnn.com/2026/01/28/business/tesla-q4-2025-earnings", "authors": [ "Chris Isidore" ], "section": "business", "summary": "Tesla CEO Elon Musk, who turned an upstart electric vehicle maker into an industry-changing powerhouse, is pulling the plug on the two models that helped get him there, as he struggles with another quarter of declining profits and car sales.", "headline": "Tesla scraps Model S and Model X to build robots", "published_at": "2026-01-28T21:11:57.591000+00:00" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"cnn.com/search_news","input":{"query":"Tesla"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find CNN articles about wildfire evacuations from the first week of March 2026, newest first. - Look up the latest coverage of interest rate decisions published between 2025-11-01 and 2025-12-15. - Show me the most relevant articles mentioning Ukraine peace talks, page 3 with 10 results per page. - Search CNN for stories on electric vehicle battery recalls sorted by relevance, limited to January 2026. - I need newest articles on the Olympic figure skating trials published from 2026-02-01 through 2026-02-28, 50 per page. ## Input schema ```json { "type": "object", "required": [ "query" ], "properties": { "page": { "type": "integer", "default": 1, "minimum": 1, "description": "Results page, for example 2." }, "sort": { "enum": [ "newest", "most_relevant" ], "type": "string", "default": "newest", "description": "Order the articles by publication time or search relevance, for example newest." }, "query": { "type": "string", "minLength": 1, "description": "Words to search CNN articles for, for example Tesla." }, "to_date": { "type": "string", "description": "Latest publication date (YYYY-MM-DD), inclusive, for example 2026-09-28." }, "from_date": { "type": "string", "description": "Earliest publication date (YYYY-MM-DD), inclusive, for example 2026-01-01." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum articles per page, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "articles" ], "properties": { "articles": { "type": "array", "items": { "type": "object", "required": [ "headline", "published_at", "authors", "link" ], "properties": { "link": { "type": "string" }, "authors": { "type": "array", "items": { "type": "string" } }, "section": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "published_at": { "type": "string" } } }, "description": "Matching CNN articles." } } } ``` ## See more - [CNN API: List headlines by section](https://fous.com/methods/cnn.com/list-headlines.md): Lists CNN headlines in the order shown on a chosen news section page (top stories, US, world, politics, business, health, entertainment or science), with each story's summary, publication time, authors and image when available. Promotions and video-only items are left out. - [CNN API: Read an article](https://fous.com/methods/cnn.com/read-article.md): Reads a CNN article by link or headline and returns its headline, summary, authors, dates, section, tags, main image and public paragraphs. Subscriber stories return only a brief public preview; live blogs include their entries. - [Reuters API: Search news](https://fous.com/methods/reuters.com/search-news.md): Searches Reuters articles by keyword through Google News, with optional publication date range, order and page. Summaries and bylines are filled in when Reuters serves the article page. - [BBC News API: Search articles](https://fous.com/methods/bbc.com/search-news.md): Finds BBC News articles matching search words, newest first or by relevance, with publication time, authors, section and summary, optionally limited to a date range. Date filters and newest order apply to the first 180 search matches; older or less relevant matches may be missed. - [CNBC API: Search articles](https://fous.com/methods/cnbc.com/search-news.md): Searches CNBC-published articles by keyword, with optional publication date range, sort order and pagination. Excludes videos, wire stories and press releases. - [NPR API: Search news](https://fous.com/methods/npr.org/search-news.md): Searches NPR-published articles by keyword, newest first or by best match, with optional publication dates, and returns each article's date, authors, section and summary. - [Yahoo API: Search Yahoo News](https://fous.com/methods/yahoo.com/search-news.md): Searches Yahoo News articles by keyword, newest first or by relevance, with optional publication dates and pages; returns only articles hosted on Yahoo News, with authors, original publisher and section. - [Fox News API: Search articles](https://fous.com/methods/foxnews.com/search-news.md): Searches Fox News articles by keyword, with date filtering, ordering and pagination, over the first 100 matches. - [All CNN methods](https://fous.com/methods/cnn.com.md)