# AP News API: List headlines > 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. Unofficial. Not affiliated with or endorsed by AP News. - Page: https://fous.com/methods/apnews.com/list-headlines - Method: `apnews.com/list_headlines`, version 1 - Website: apnews.com - Returns: headline, summary, published time, 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 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `section` | string | no | `"world"` | News section to list, for example world. One of "top stories", "U.S. news", "world", "politics", "business", "sports", "entertainment", "science", "health". Default "top stories". | | `max_results` | integer | no | `50` | Maximum number of stories to return, for example 20. Default 20. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "section": "world", "max_results": 50 } ``` Its output: ```json { "stories": [ { "authors": [ "The Associated Press" ], "section": "World News", "summary": "Israel says it killed two gunmen and thwarted a “terror attack” against Israeli civilians. The Prime Minister’s Office said Friday it had instructed the army to close the West Bank, where the attack occurred.", "headline": "Israel says it thwarted ‘terror attack,’ and other Middle East developments", "image_url": "https://dims.apnews.com/dims4/default/a8866ce/2147483647/strip/true/crop/8640x5760+0+0/resize/727x485!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F37%2F58%2F62b2bdfebc8f04ef06c143ce60e5%2F9d9d84235e144b488e0766f521e22f9b", "article_url": "https://apnews.com/article/mideast-news-october-23-2026-6424dff433a4f99f00cac2328de0f7a4", "published_at": "2026-10-23T08:51:48+00:00" }, { "authors": [ "Shlomo Mor", "Sam Mednick" ], "section": "World News", "summary": null, "headline": "Netanyahu’s office orders closure of West Bank after soldiers kill 2 men behind an alleged attack", "image_url": "https://dims.apnews.com/dims4/default/d095ac8/2147483647/strip/true/crop/6000x4000+0+0/resize/599x399!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F92%2F65%2F40a1ff976bc5f6f2279d62001889%2Fd14f5d6b2f484ceca11eedd48792ba52", "article_url": "https://apnews.com/article/israel-shooting-west-bank-election-f6646718072b4ff6929cff43297edd05", "published_at": "2026-10-23T08:41:19+00:00" }, { "authors": [ "Melanie Lidman" ], "section": "World News", "summary": null, "headline": "In Netanyahu stronghold, signs of fraying loyalty emerge before election", "image_url": "https://dims.apnews.com/dims4/default/54071b1/2147483647/strip/true/crop/3000x2000+0+0/resize/599x399!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F0d%2F0c%2F9e216ea0ff586e1488b4b61259bf%2F27eab28c2c77469d927d3336207360a4", "article_url": "https://apnews.com/article/israel-elections-netanyahu-north-hezbollah-war-88eb7c38cefd13f576778c918a1b8f74", "published_at": "2026-10-23T06:58:40+00: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":"apnews.com/list_headlines","input":{"section":"world","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 15 headlines from the world section with summaries and publish times - Can you list up to 30 top stories right now, including who wrote each one? - I need the newest politics stories from AP News, maybe 10 of them, with article links - Pull the 25 most recent business headlines and include the section and image URLs - Give me a list of 40 science stories in the order they appear on the section page ## Input schema ```json { "type": "object", "required": [], "properties": { "section": { "enum": [ "top stories", "U.S. news", "world", "politics", "business", "sports", "entertainment", "science", "health" ], "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 ```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" } }, "section": { "type": "string" }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "image_url": { "type": [ "string", "null" ] }, "article_url": { "type": "string" }, "published_at": { "type": [ "string", "null" ] } } } } } } ``` ## See more - [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: 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. - [Reuters API: List headlines](https://fous.com/methods/reuters.com/list-headlines.md): Lists the latest Reuters stories from a news section (top stories, business, markets, world, technology, legal or sustainability) in page order. - [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. - [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. - [Fox News API: List headlines](https://fous.com/methods/foxnews.com/list-headlines.md): Lists Fox News article headlines in the order shown on a news section page. Video-only items, ads and promotions are left out. - [wsj.com API: List Wall Street Journal section headlines](https://fous.com/methods/wsj.com/list-headlines.md): Lists the headlines shown in a Wall Street Journal news section (top stories, business, markets, tech, economy, world, politics or personal finance) with summaries, bylines, dates, images and story links. - [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. - [All AP News methods](https://fous.com/methods/apnews.com.md)