# CNN API: Read an article > 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. Unofficial. Not affiliated with or endorsed by CNN. - Page: https://fous.com/methods/cnn.com/read-article - Method: `cnn.com/read_article`, version 1 - Website: cnn.com - Returns: headline, summary, authors, dates, section, tags, main image, paragraphs, article URL and ID - 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 | |---|---|---|---|---| | `article` | string | yes | `"https://www.cnn.com/2026/09/28/politics/justice-alito-recuses-climate-change-boulder-suncor"` | CNN article link or headline, for example Alito recuses himself from major Supreme Court climate change case. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "article": "https://www.cnn.com/2026/09/28/politics/justice-alito-recuses-climate-change-boulder-suncor" } ``` Its output: ```json { "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 environmental groups that argued he was compromised by his financial holdings in the oil and gas industry.", "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 environmental groups that argued he was compromised by his financial holdings in the oil and gas industry.", "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 offer further explanation for the decision.", "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 caused by climate change, or whether state tort laws are preempted by federal law and separation of po…" ], "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 } ``` ## 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/read_article","input":{"article":"https://www.cnn.com/2026/09/28/politics/justice-alito-recuses-climate-change-boulder-suncor"}}' ``` 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 - Pull up the CNN story at https://www.cnn.com/2024/03/12/politics/supreme-court-climate-case/index.html and give me its headline, authors and publish date. - Can you read the article titled Alito recuses himself from major Supreme Court climate change case and summarize it for me? - I need the full public paragraphs and tags from the CNN piece about the latest live blog on the Gaza ceasefire talks. - Look up the article 'Storm system forecast to drop heavy snow across the Rockies this weekend' and tell me its section and main image. - Retrieve the article ID and article URL for the CNN story on rising egg prices, plus any subscriber preview text it shows. ## Input schema ```json { "type": "object", "required": [ "article" ], "properties": { "article": { "type": "string", "minLength": 1, "description": "CNN article link or headline, for example Alito recuses himself from major Supreme Court climate change case." } } } ``` ## Output schema ```json { "type": "object", "required": [ "headline", "summary", "authors", "published_at", "updated_at", "section", "tags", "main_image_url", "main_image_caption", "paragraphs", "full_text_available", "word_count", "article_url", "article_id" ], "properties": { "tags": { "type": "array", "items": { "type": "string" } }, "authors": { "type": "array", "items": { "type": "string" } }, "section": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "article_id": { "type": [ "string", "null" ], "x-fous-developer": true }, "paragraphs": { "type": "array", "items": { "type": "string" } }, "updated_at": { "type": [ "string", "null" ], "format": "date-time" }, "word_count": { "type": "integer" }, "article_url": { "type": "string" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "main_image_url": { "type": [ "string", "null" ] }, "main_image_caption": { "type": [ "string", "null" ] }, "full_text_available": { "type": "boolean" } }, "additionalProperties": false } ``` ## 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: Search news](https://fous.com/methods/cnn.com/search-news.md): Searches CNN articles by keyword, with optional publication date range, sort order and pagination. - [BBC News API: Read article](https://fous.com/methods/bbc.com/read-article.md): Reads the text and details of a BBC News article from its link or headline. Live coverage pages return the latest entries available. - [NPR API: Read article](https://fous.com/methods/npr.org/read-article.md): Reads an NPR article by its link or headline and returns its text and publication details. For live blogs, returns the displayed updates. - [AP News API: Read article](https://fous.com/methods/apnews.com/read-article.md): Reads the full text and details of one public AP News article from its link or headline. - [The Guardian API: Read article](https://fous.com/methods/theguardian.com/read-article.md): Reads one public Guardian article by link or headline and returns its details and available full-text paragraphs. Live blogs return the latest entries shown on the page; some older articles may be unavailable. - [Yahoo API: Read article](https://fous.com/methods/yahoo.com/read-article.md): Reads a public Yahoo News article from its link or headline and returns its text and details. Headline matching uses Yahoo News search results. - [TechCrunch API: Read an article](https://fous.com/methods/techcrunch.com/read-article.md): Reads a public TechCrunch article by link or headline and returns its text, authors, dates, section, tags and image. Live blogs return their latest public updates. - [All CNN methods](https://fous.com/methods/cnn.com.md)