CNN API: List headlines by section
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.
Unofficial. Not affiliated with or endorsed by CNN.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Section optional
section News section to list, for example world.
top stories
One of
top stories,US,world,politics,business,health,entertainment,science. Defaulttop stories.- Max Results optional
max_results Maximum number of stories to return, for example 20.
50
Whole number from 1 to 50. Default
20.
Input as JSON
{ "section": "top stories", "max_results": 50}Output
{ "stories": [ { "authors": [ "Steven Jiang", "Issy Ronald", "Mike Valerio" ], "section": "top stories", "summary": "Two giant pandas on loan from the Chinese government as part of Beijing’s long tradition of “panda diplomacy” have arrived at Zoo Atlanta.", "headline": "Panda diplomacy", "image_link": "https://media.cnn.com/api/v1/images/stellar/prod/fu-shuang-7-750x500.jpg?c=16x9&q=w_800,c_fill" , "article_link": "https://www.cnn.com/2026/09/26/asia/two-giant-pandas-leave-on-a-flight-bound-for-zoo-atlanta-in-a-rare-loan-from-china-latam-intl" , "published_at": "2026-09-26T23:29:42.579000+00:00" }, { "authors": [ "Ashley Strickland", "Jackie Wattles", "Tal Yellin" ], "section": "top stories", "summary": "SpaceX’s Starship rocket, the most powerful rocket ever made, made it to orbit for the first time despite engine trouble.", "headline": "SpaceX", "image_link": "https://media.cnn.com/api/v1/images/stellar/prod/2026-09-28t125953z-2009112740-rc2csnabzaqm-rtrmadp-3-space-spacex-starship.jpg?c=16x9&q=w_800,c_fill" , "article_link": "https://www.cnn.com/2026/09/28/science/live-news/spacex-starship-flight-14-launch" , "published_at": "2026-09-28T10:03:59.237000+00:00" }, { "authors": [ "Christopher Lamb" ], "section": "top stories", "summary": "France may have a highly secularized culture, but it has given Pope Leo XIV a superstar welcome.", "headline": "Pope Leo", "image_link": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2297265842.jpg?c=16x9&q=w_800,c_fill" , "article_link": "https://www.cnn.com/2026/09/28/europe/pope-leo-france-visit-intl" , "published_at": "2026-09-28T13:58:45.499000+00:00" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"cnn.com/list_headlines","input":{"section":"top stories","max_results":50}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "cnn.com/list_headlines" , "input": { "section": "top stories", "max_results": 50 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "cnn.com/list_headlines" , "input": { "section": "top stories", "max_results": 50 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run cnn.com/list_headlines# with {"section":"top stories","max_results":50}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "properties": { "section": { "enum": [ "top stories", "US", "world", "politics", "business", "health", "entertainment", "science" ], "type": "string", "default": "top stories", "description": "News section to list, for example world." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of stories to return, for example 20." } }}Output schema
{ "type": "object", "required": [ "stories" ], "properties": { "stories": { "type": "array", "items": { "type": "object", "required": [ "headline", "summary", "published_at", "authors", "section", "image_link", "article_link" ], "properties": { "authors": { "type": "array", "items": { "type": "string" } }, "section": { "type": "string" }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "image_link": { "type": [ "string", "null" ] }, "article_link": { "type": "string" }, "published_at": { "type": [ "string", "null" ], "description": "Publication date and time in ISO 8601 with offset, if shown." } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
cnn.com/list_headlines- Returns
- headline, summary, published at, authors, section, image link, article link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method cnn.com/list_headlines with the inputs above.
Ask your agent
- What are the top 10 stories on CNN's politics page right now, with summaries and who wrote them?
- Give me the latest world news headlines in the order they appear, up to 25 stories, including publish times and article links.
- Pull the current health section headlines from CNN — just the first 5, with images if available.
- I need a rundown of today's business news headlines with authors and when each was published, max 30.
- Show me the current lineup of science stories, about 15 of them, with a short summary for each.
See more
All CNN methodsSearches CNN articles by keyword, with optional publication date range, sort order and pagination.
cnn.com/search_newsReads 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.
cnn.com/read_articleLists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link.
bbc.com/list_headlinesLists the headlines on an NPR section page in page order, with summaries, publication times, authors, images and article links.
npr.org/list_headlinesLists CNBC article headlines in the order they appear on a public news section page, with summary, time, authors and image.
cnbc.com/list_headlinesLists Fox News article headlines in the order shown on a news section page. Video-only items, ads and promotions are left out.
foxnews.com/list_headlinesLists the latest Yahoo News headlines for a section in page order, with summary, byline, original publisher, image and publication time when the article provides them.
yahoo.com/list_headlinesLists the latest Reuters stories from a news section (top stories, business, markets, world, technology, legal or sustainability) in page order.
reuters.com/list_headlines