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.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Section optional
section News section to list, for example world.
world
One of
top stories,U.S. news,world,politics,business,sports,entertainment,science,health. Defaulttop stories.- Max Results optional
max_results Maximum number of stories to return, for example 20.
50
Whole number from 1 to 50. Default
20.
Input as JSON
{ "section": "world", "max_results": 50}Output
{ "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" } ]}Code
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}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "apnews.com/list_headlines" , "input": { "section": "world", "max_results": 50 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "apnews.com/list_headlines" , "input": { "section": "world", "max_results": 50 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run apnews.com/list_headlines# with {"section":"world","max_results":50}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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" ] } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
apnews.com/list_headlines- Returns
- headline, summary, published time, authors, section, image URL, article URL
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method apnews.com/list_headlines with the inputs above.
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
See more
All AP News methodsReads the full text and details of one public AP News article from its link or headline.
apnews.com/read_articleLists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link.
bbc.com/list_headlinesLists the latest Reuters stories from a news section (top stories, business, markets, world, technology, legal or sustainability) in page order.
reuters.com/list_headlinesLists the headlines on an NPR section page in page order, with summaries, publication times, authors, images and article links.
npr.org/list_headlinesLists 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.
yahoo.com/list_headlinesLists Fox News article headlines in the order shown on a news section page. Video-only items, ads and promotions are left out.
foxnews.com/list_headlinesLists 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.
wsj.com/list_headlinesLists 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.com/list_headlines