# NPR API: List headlines > Lists the headlines on an NPR section page in page order, with summaries, publication times, authors, images and article links. Unofficial. Not affiliated with or endorsed by NPR. - Page: https://fous.com/methods/npr.org/list-headlines - Method: `npr.org/list_headlines`, version 1 - Website: npr.org - Returns: headline, summary, published_at, authors, section, image_url, article_url - 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 | |---|---|---|---|---| | `section` | string | no | `"national"` | The NPR news section to read, for example world. One of "top stories", "national", "world", "politics", "business", "health", "science", "climate". Default "top stories". | | `max_results` | integer | no | `50` | Maximum number of headlines to return, for example 20. Default 20. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "section": "national", "max_results": 50 } ``` Its output: ```json { "stories": [ { "authors": [ "Frank Langfitt" ], "section": "American Identity", "summary": "At least four Trump merchandise stores have closed this year. Store owners say with Trump in his final term, there isn't as much to fire up his consumer fan base and sales have softened.", "headline": "Trump merchandise stores are closing: 'He has peaked'", "image_url": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/4032x2268+0+378/resize/800/quality/100/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F71%2F12%2Fce971cb04c06a4a07472c7528d90%2Fwhatsapp-image-2026-10-19-at-17-52-19.jpeg", "article_url": "https://www.npr.org/2026/10/22/nx-s1-6002970/trump-merchandise-stores-closing-maga-midterms", "published_at": "2026-10-22T05:00:00-04:00" }, { "authors": [ "Jennifer Ludden" ], "section": "Affordability", "summary": "A new analysis finds that the average renter household now needs 16 years to save for a down payment and closing costs. Rising rents and other costs have consumed a growing share of household budgets.", "headline": "How long does it take to save up for a starter home? Twice as long as it did in 2019", "image_url": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/5794x3259+0+341/resize/800/quality/100/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F72%2F4f%2Fa6ef628346e5b0e8961027373fce%2Fgettyimages-2285398485.jpg", "article_url": "https://www.npr.org/2026/10/22/nx-s1-6009378/down-payment-real-estate-affordability", "published_at": "2026-10-22T05:00:00-04:00" }, { "authors": [ "Jaclyn Diaz" ], "section": "Criminal Justice", "summary": "The Supreme Court ruled Wednesday that the Trump administration has to continue providing gender-affirming care to inmates in federal prisons as litigation on efforts to change the policy continues.", "headline": "Supreme Court upholds pause on Trump's anti-trans prison policy", "image_url": "https://npr.brightspotcdn.com/dims3/default/strip/false/crop/8126x4571+0+423/resize/800/quality/100/format/jpeg/?url=http%3A%2F%2Fnpr-brightspot.s3.amazonaws.com%2F32%2Fca%2F101aa09243d3b3fa4de648137a9e%2Fgettyimages-2299615293.jpg", "article_url": "https://www.npr.org/2026/10/21/nx-s1-5993878/supreme-court-trump-trans-prison-policy", "published_at": "2026-10-21T11:46:27-04: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":"npr.org/list_headlines","input":{"section":"national","max_results":50}}' ``` 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 - Show me the latest headlines from NPR's world section, around 15 of them with summaries and links. - What are today's top stories on NPR? Give me up to 20 with authors and publication times. - I need the newest climate coverage from npr.org, listing headlines with their images and article links. - Pull the first 30 politics headlines in page order from NPR, including who wrote each one. - Get me a quick rundown of NPR's health news, maybe 10 headlines with short summaries. ## Input schema ```json { "type": "object", "required": [], "properties": { "section": { "enum": [ "top stories", "national", "world", "politics", "business", "health", "science", "climate" ], "type": "string", "default": "top stories", "description": "The NPR news section to read, for example world." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of headlines to return, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "stories" ], "properties": { "stories": { "type": "array", "items": { "type": "object", "required": [ "headline", "summary", "published_at", "authors", "section", "image_url", "article_url" ], "properties": { "authors": { "type": "array", "items": { "type": "string" }, "description": "Credited authors, empty if none are shown." }, "section": { "type": "string" }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "image_url": { "type": [ "string", "null" ] }, "article_url": { "type": "string" }, "published_at": { "type": [ "string", "null" ], "description": "Publication time with UTC offset, or null if not shown." } }, "additionalProperties": false }, "description": "NPR stories in the same order as the selected page." } }, "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: 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. - [BBC News API: List headlines](https://fous.com/methods/bbc.com/list-headlines.md): Lists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link. - [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. - [AP News API: List headlines](https://fous.com/methods/apnews.com/list-headlines.md): Lists AP News headlines in the order shown on a public section page, up to 50 stories. Author credits and the article section are added for the first 20 articles only. - [Yahoo API: List Yahoo News headlines](https://fous.com/methods/yahoo.com/list-headlines.md): Lists 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. - [The New York Times API: List headlines](https://fous.com/methods/nytimes.com/list-headlines.md): Lists current New York Times headlines with summaries, authors, images and publication times, in the order shown on the chosen section page (top stories or a section). Video-only items, ads and promotions are left out; times come from the section's feed and may be missing. - [The Verge API: List headlines](https://fous.com/methods/theverge.com/list-headlines.md): Lists The Verge story headlines, including quick posts, in the order shown on a section page. Archive pages are added when more stories are needed. - [All NPR methods](https://fous.com/methods/npr.org.md)