# NPR API: Read article > Reads an NPR article by its link or headline and returns its text and publication details. For live blogs, returns the displayed updates. Unofficial. Not affiliated with or endorsed by NPR. - Page: https://fous.com/methods/npr.org/read-article - Method: `npr.org/read_article`, version 1 - Website: npr.org - Returns: headline, summary, authors, dates, section, tags, image, paragraphs - 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.npr.org/live-updates/plane-helicopter-crash-dc-airport-potomac"` | NPR article link or headline, for example: The Trump administration weakens fuel efficiency standards for new cars. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "article": "https://www.npr.org/live-updates/plane-helicopter-crash-dc-airport-potomac" } ``` Its output: ```json { "tags": [], "authors": [ "NPR Washington Desk", "Chandelis Duster", "Lisa Hagen" ], "section": null, "summary": "A regional jet carrying 64 people collided in midair with a Black Hawk helicopter as the plane was approaching a runway at Ronald Reagan Washington National Airport on Wednesday night.", "headline": "Live updates: D.C. plane crash victims include U.S. figure skaters, former Russian world champions", "article_id": "00000194-b6e6-db77-afb5-bfffb1ee0000", "paragraphs": [ "Trump says Americans shouldn't be afraid to fly", "Asked if Americans should feel hesitant to fly, President Trump said:", "“No. Not at all. I would not hesitate to fly. This is something that — it’s been many years since something like this has happened, and the collision is just something that we don’t expect it to happen ever again,” he said." ], "updated_at": "2025-01-30T16:53:38.970000+00:00", "word_count": 3535, "article_url": "https://www.npr.org/live-updates/plane-helicopter-crash-dc-airport-potomac", "published_at": "2025-01-30T11:23:26.046000+00:00", "main_image_url": "https://npr.brightspotcdn.com/aa/84/deb43f92403d9e2602488754a62c/dscf0031-edit.jpg", "main_image_caption": "A boat works the scene in the Potomac River near Ronald Reagan Washington National Airport early Thursday morning.", "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":"npr.org/read_article","input":{"article":"https://www.npr.org/live-updates/plane-helicopter-crash-dc-airport-potomac"}}' ``` 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 - Can you pull up the full text of this NPR story about the new fuel efficiency rule and tell me who wrote it and when it was published? - I need the byline, publication date, and section for the NPR article titled 'The Trump administration weakens fuel efficiency standards for new cars.' - Grab the paragraphs and tags from https://www.npr.org/2024/03/15/heat-wave-climate-report and summarize what it covers. - Show me the headline, image, and summary of the latest NPR piece on rising grocery prices, plus the updates if it's a live blog. - What does the NPR article about the Senate budget vote say, and which tags and section is it filed under? ## Input schema ```json { "type": "object", "required": [ "article" ], "properties": { "article": { "type": "string", "description": "NPR article link or headline, for example: The Trump administration weakens fuel efficiency standards for new cars." } }, "additionalProperties": false } ``` ## 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" }, "description": "Article tags" }, "authors": { "type": "array", "items": { "type": "string" }, "description": "Article authors" }, "section": { "type": [ "string", "null" ], "description": "NPR section" }, "summary": { "type": [ "string", "null" ], "description": "Article summary or standfirst" }, "headline": { "type": "string", "description": "Article headline" }, "article_id": { "type": [ "string", "null" ], "description": "NPR article ID", "x-fous-developer": true }, "paragraphs": { "type": "array", "items": { "type": "string" }, "description": "Article text paragraphs" }, "updated_at": { "type": [ "string", "null" ], "description": "Last updated date and time" }, "word_count": { "type": "integer", "description": "Word count of returned text" }, "article_url": { "type": "string", "description": "NPR article link" }, "published_at": { "type": [ "string", "null" ], "description": "Publication date and time" }, "main_image_url": { "type": [ "string", "null" ], "description": "Main image link" }, "main_image_caption": { "type": [ "string", "null" ], "description": "Main image caption" }, "full_text_available": { "type": "boolean", "description": "Whether the full text is present" } }, "additionalProperties": false } ``` ## See more - [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. - [NPR API: List headlines](https://fous.com/methods/npr.org/list-headlines.md): Lists the headlines on an NPR section page in page order, with summaries, publication times, authors, images and article links. - [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. - [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. - [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. - [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. - [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. - [Al Jazeera API: Read an article](https://fous.com/methods/aljazeera.com/read-article.md): Reads one public Al Jazeera article from its link, or from a headline (the best match of the site's own search), and returns its text and details; live blogs give their latest ten entries. - [All NPR methods](https://fous.com/methods/npr.org.md)