CNN provides section-page headlines and searchable public articles, plus article text; subscriber stories show only a brief public preview, and live blogs include entries.
Your information
News section to list, for example world.
Maximum number of stories to return, for example 20.
Example results
Headlines
Section: US
About the CNN tool
CNN’s List headlines method returns stories from a selected news section and takes a section, with an optional result maximum.
CNN’s Search news method returns articles matching required search words, with optional dates, sort order, page, and result maximum.
CNN’s Read article method returns public text and details for an article link or headline; subscriber stories provide only a brief public preview.
Built from cnn.com. Last checked Sep 28, 2026.
Actions
List headlines
1 creditList CNN headlines in the order shown on a selected news section page, with story details when available. Excludes promotions and video-only items.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Sectionsection | Text | Optional | News section to list, for example world.Example: US |
Max Resultsmax_results | Number | Optional | Maximum number of stories to return, for example 20.Example: 5 |
What you get
| Field | Type | Description |
|---|---|---|
Storiesstories | List | |
Authorsstories[].authors | List | |
Sectionstories[].section | Text | Example: US |
Summarystories[].summary | Text | Example: CNN’s 5 Things PM brings you the stories you might have missed during your… |
Headlinestories[].headline | Text | Example: Starship passes test, fact-checking Trump, tales from the DMV: Catch up on the… |
Image Linkstories[].image_link | Text | Example: https://media.cnn.com/api/v1/images/stellar/prod/ap26271485626484.jpg?c=original |
Article Linkstories[].article_link | Text | Example: https://www.cnn.com/2026/09/28/us/5-things-september-28-trnd |
Published Atstories[].published_at | Text | Publication date and time in ISO 8601 with offset, if shown.Example: 2026-09-28T21:05:43.857000+00:00 |
Example result
For Section: US, Max Results: 5
{
"stories": [
{
"authors": [
"Daniel Wine"
],
"section": "US",
"summary": "CNN’s 5 Things PM brings you the stories you might have missed during your busy day.",
"headline": "Starship passes test, fact-checking Trump, tales from the DMV: Catch up on the day’s stories",
"image_link": "https://media.cnn.com/api/v1/images/stellar/prod/ap26271485626484.jpg?c=original",
"article_link": "https://www.cnn.com/2026/09/28/us/5-things-september-28-trnd",
"published_at": "2026-09-28T21:05:43.857000+00:00"
},
{
"authors": [
"Nicki Brown",
"Eric Levenson"
],
"section": "US",
"summary": "The prosecution and defense rested Monday in the murder trial of Caleb Flynn, the former “American Idol” contestant accused of killing his wife and staging the crime scene.",
"headline": "Caleb Flynn’s defense rests without calling any witnesses in his murder trial",
"image_link": "https://media.cnn.com/api/v1/images/stellar/prod/caleb-flynn-092526-1.jpg?c=original",
"article_link": "https://www.cnn.com/2026/09/28/us/caleb-flynn-trial",
"published_at": "2026-09-28T19:02:18.329000+00:00"
},
{
"authors": [
"Hanna Park",
"Danya Gainor",
"Holly Yan"
],
"section": "US",
"summary": "Prosecutors in New York are reopening an investigation into an alleged gang rape of a former Cornell University student after the woman filed a civil lawsuit this month claiming the school did not do …",
"headline": "New York prosecutors reopen investigation after student files lawsuit over alleged gang rape at Cornell University",
"image_link": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-1762566666.jpg?c=original",
"article_link": "https://www.cnn.com/2026/09/28/us/cornell-university-sexual-assault-lawsuit-hnk",
"published_at": "2026-09-28T11:29:57.532000+00:00"
}
]
}Read article
1 creditRead the headline, details, and public text of a CNN article from its link or headline. Subscriber stories return only a brief public preview; live blogs include their entries.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Articlearticle | Text | Required | CNN article link or headline, for example Alito recuses himself from major Supreme Court climate change case.Example: https://www.cnn.com/2026/09/28/politics/justice-alito-recuses-climate-change-bo… |
What you get
| Field | Type | Description |
|---|---|---|
Tagstags | List | |
Authorsauthors | List | |
Sectionsection | Text | Example: Politics |
Summarysummary | Text | Example: Supreme Court Justice Samuel Alito announced Monday that he will recuse… |
Headlineheadline | Text | Example: Alito recuses himself from major Supreme Court climate change case |
Article IDarticle_id | Text | Example: cmuljayrn000027qj5nx0drzl |
Paragraphsparagraphs | List | |
Updated Atupdated_at | Date | Example: 2026-09-28T19:56:55.246+00:00 |
Word Countword_count | Number | Example: 329 |
Article URLarticle_url | Text | Example: https://www.cnn.com/2026/09/28/politics/justice-alito-recuses-climate-change-bo… |
Published Atpublished_at | Date | Example: 2026-09-28T18:07:16.542+00:00 |
Main Image URLmain_image_url | Text | Example: https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2194936744.jpg?c=o… |
Main Image Captionmain_image_caption | Text | Example: Associate Supreme Court Justice Samuel Alito Jr. attends President Donald… |
Full Text Availablefull_text_available | Yes or no | Example: Yes |
Example result
For Article: https://www.cnn.com/2026/09/28/politics/justice-alito-recuses-climate-change-boulder-suncor
{
"tags": [],
"authors": [
"John Fritze"
],
"section": "Politics",
"summary": "Supreme Court Justice Samuel Alito announced Monday that he will recuse himself from a major climate change-related case the court is set to hear next week, following weeks of pressure from environmen…",
"headline": "Alito recuses himself from major Supreme Court climate change case",
"article_id": "cmuljayrn000027qj5nx0drzl",
"paragraphs": [
"Supreme Court Justice Samuel Alito announced Monday that he will recuse himself from a major climate change-related case the court is set to hear next week, following weeks of pressure from environmen…",
"In a brief letter sent to the parties in the case, the Supreme Court’s clerk wrote that the conservative justice had “determined that he will not continue to participate in this case,” but did not off…",
"The climate issue will be the first case argued at the Supreme Court as it opens its new term next Monday. It deals with whether Boulder, Colorado, may sue Suncor Energy and Exxon Mobil for damages ca…"
],
"updated_at": "2026-09-28T19:56:55.246+00:00",
"word_count": 329,
"article_url": "https://www.cnn.com/2026/09/28/politics/justice-alito-recuses-climate-change-boulder-suncor",
"published_at": "2026-09-28T18:07:16.542+00:00",
"main_image_url": "https://media.cnn.com/api/v1/images/stellar/prod/gettyimages-2194936744.jpg?c=original",
"main_image_caption": "Associate Supreme Court Justice Samuel Alito Jr. attends President Donald Trump's inauguration in the Rotunda of the US Capitol on January 20, 2025.",
"full_text_available": true
}Search news
1 creditSearch CNN articles by keyword, with optional publication dates, sort order, and pagination. Returns public CNN article details.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Pagepage | Number | Optional | Results page, for example 2.Example: 2 |
Sortsort | Text | Optional | Order the articles by publication time or search relevance, for example newest.Example: Most relevant |
Queryquery | Text | Required | Words to search CNN articles for, for example Tesla.Example: Tesla |
To Dateto_date | Date | Optional | Latest publication date, inclusive, for example 2026-09-28.Example: 2026-09-28 |
From Datefrom_date | Date | Optional | Earliest publication date, inclusive, for example 2026-01-01.Example: 2026-01-01 |
Max Resultsmax_results | Number | Optional | Maximum articles per page, for example 20.Example: 3 |
What you get
| Field | Type | Description |
|---|---|---|
Articlesarticles | List | Matching CNN articles. |
Linkarticles[].link | Link | Example: https://www.cnn.com/2026/01/13/business/tesla-robotaxi-musk-2026 |
Authorsarticles[].authors | List | |
Sectionarticles[].section | Text | Example: Business |
Summaryarticles[].summary | Text | Example: Tesla’s robotaxi service has been mostly hypothetical so far, but it’s… |
Headlinearticles[].headline | Text | Example: Tesla’s profit engine is sputtering. Elon Musk has bet its future on a promise… |
Published Atarticles[].published_at | Date | Example: 2026-01-13T12:00:59.529000+00:00 |
Example result
For Page: 2, Sort: Most relevant, Query: Tesla, Max Results: 3
{
"articles": [
{
"link": "https://www.cnn.com/2026/01/13/business/tesla-robotaxi-musk-2026",
"authors": [
"Chris Isidore"
],
"section": "business",
"summary": "Tesla’s robotaxi service has been mostly hypothetical so far, but it’s certainly taking the company’s shareholders for a real ride.",
"headline": "Tesla’s profit engine is sputtering. Elon Musk has bet its future on a promise he’s far from delivering",
"published_at": "2026-01-13T12:00:59.529000+00:00"
},
{
"link": "https://www.cnn.com/2026/01/02/business/tesla-byd-ev",
"authors": [
"Chris Isidore, John Liu"
],
"section": "business",
"summary": "In 2011, Tesla CEO Elon Musk dismissed Chinese electric vehicle maker BYD as a competitor. But some 14 years later, BYD beat the American EV pioneer at its own game.",
"headline": "The world has a new EV king. It’s not Tesla",
"published_at": "2026-01-02T14:21:52.167000+00:00"
},
{
"link": "https://www.cnn.com/2025/10/22/business/tesla-earnings",
"authors": [
"Chris Isidore"
],
"section": "business",
"summary": "Tesla reported a quarterly revenue record Wednesday, but earnings still managed to miss analyst forecasts and fall from a year ago.",
"headline": "Tesla’s best quarter of year isn’t enough to impress investors. Because they know it won’t last",
"published_at": "2025-10-22T11:00:54.032000+00:00"
}
]
}For developers
Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 180 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@cnn",
"visibility": "public",
"operation": "list_headlines",
"version": 1,
"input": {
"section": "US",
"max_results": 5
},
"response": {
"format": "json"
}
}'What you can do with it
- Track headlines across selected news sections
- Find articles about a topic within a date range
- Review public article text and details for research
- Monitor article authors, sections, and publication times
Questions about CNN
Can I run it with my own inputs?
Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.
Can I call this CNN tool as an API?
Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.
How much does it cost?
Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.
Do I need a CNN account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from cnn.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 28, 2026.
What headlines appear in a selected news section?
List headlines returns stories in the order shown on the selected section page.
Which CNN articles match a search term?
Search news finds articles matching the required query, with optional publication dates and sort order.
What does a CNN article say?
Read article returns public article text and details from a link or headline; subscriber stories provide only a brief public preview.