# Yahoo News API

> Yahoo News returns headlines, article search results, and article text as a workflow and API.

Yahoo News (Yahoo) lists headlines by section, using a section and optional maximum number of results as input. Search news finds Yahoo News articles by keyword, with optional dates, ordering, page, and result count. Read article returns text and details for a public Yahoo News article, using its link or headline.

- Page: https://fous.com/tools/yahoo-news
- Handle: `@yahoo-news`
- Category: [News](https://fous.com/tools/category/news)
- Source website: https://yahoo.com/news
- Last verified: Sep 29, 2026

## Methods

### List headlines

Operation `list_headlines`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List the latest Yahoo News headlines in page order for a selected section, with bylines, original publishers, images, and publication times when available. The Yahoo News health section currently has no public section page, so health returns no stories.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `section` | string | no | `"US"` | News section to list, for example world. |
| `max_results` | integer | no | `5` | Maximum number of headlines to return, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "section": {
      "enum": [
        "top stories",
        "US",
        "world",
        "politics",
        "health",
        "science"
      ],
      "type": "string",
      "default": "top stories",
      "description": "News section to list, for example world.",
      "examples": [
        "US",
        "top stories",
        "health"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of headlines to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        5,
        50
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "section": "US",
      "max_results": 5
    },
    {
      "section": "top stories"
    },
    {
      "section": "health"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `stories` | array |  |  |
| `stories[].authors` | array |  |  |
| `stories[].section` | string | `"US"` |  |
| `stories[].summary` | string or null | `"A GoFundMe for a Texas couple has been pulled after receiving over $700,000 in donations. Here's why the \"HelpDonRetir` |  |
| `stories[].headline` | string | `"GoFundMe pulls viral $745K campaign for 81-year-old luggage deliverer"` |  |
| `stories[].image_link` | string or null | `"https://s.yimg.com/lo/mysterio/api/99ce6086eede9fd6e93bbd1300022292a623b5b8d753603e5f1d9cbcb072f416/lightyear_networkap` |  |
| `stories[].article_link` | string | `"https://www.yahoo.com/news/us/articles/gofundme-pulls-viral-745k-campaign-002831147.html"` |  |
| `stories[].published_at` | string or null | `"2026-09-29T00:28:31+00:00"` | Publication date and time with UTC offset, or null when unavailable. |
| `stories[].original_publisher` | string or null | `"USA TODAY"` |  |

**Example input**

```json
{
  "section": "US",
  "max_results": 5
}
```

**Example output**

```json
{
  "stories": [
    {
      "authors": [
        "Jonathan Limehouse, USA TODAY"
      ],
      "section": "US",
      "summary": "A GoFundMe for a Texas couple has been pulled after receiving over $700,000 in donations. Here's why the \"HelpDonRetire\" fundraiser was removed.",
      "headline": "GoFundMe pulls viral $745K campaign for 81-year-old luggage deliverer",
      "image_link": "https://s.yimg.com/lo/mysterio/api/99ce6086eede9fd6e93bbd1300022292a623b5b8d753603e5f1d9cbcb072f416/lightyear_networkapi/resizefill_w1200%3Bquality_80%3Bformat_webp/https%3A%2F%2Fmedia.zenfs.com%2Fen%…",
      "article_link": "https://www.yahoo.com/news/us/articles/gofundme-pulls-viral-745k-campaign-002831147.html",
      "published_at": "2026-09-29T00:28:31+00:00",
      "original_publisher": "USA TODAY"
    },
    {
      "authors": [
        "Lucia I Suarez Sang"
      ],
      "section": "US",
      "summary": "A woman, identified only as Jane Doe, alleges she was gang-raped by seven fraternity members in 2024 and accuses Cornell University of failing to protect her...",
      "headline": "Details emerge in case of former Cornell student alleging rape by frat members",
      "image_link": "https://s.yimg.com/lo/mysterio/api/1d80d29c41f9b621aa49597e2430b1af7efeb36019b2ea080b6838550520ff90/lightyear_networkapi/resizefill_w1200%3Bquality_80%3Bformat_webp/https%3A%2F%2Fmedia.zenfs.com%2Fen%…",
      "article_link": "https://www.yahoo.com/news/us/articles/details-emerge-case-former-cornell-183300028.html",
      "published_at": "2026-09-29T00:26:49+00:00",
      "original_publisher": "CBS News"
    }
  ]
}
```

### Read article

Operation `read_article`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Read the text and details of a public Yahoo News article from its link or headline. Headline matching uses available search results; syndicated live blogs may show only their latest excerpts.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `article` | string | yes | `"https://www.yahoo.com/news/world/articles/two-dead-26-injured-coach-074835373.html"` | Yahoo News article link or headline, such as Two dead, 26 injured after coach overturns in southern Germany. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "article"
  ],
  "properties": {
    "article": {
      "type": "string",
      "description": "Yahoo News article link or headline, such as Two dead, 26 injured after coach overturns in southern Germany.",
      "examples": [
        "https://www.yahoo.com/news/world/articles/two-dead-26-injured-coach-074835373.html",
        "Two dead, 26 injured after coach overturns in southern Germany",
        "https://www.yahoo.com/news/politics/articles/iran-live-updates-saudi-foreign-080920533.html"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "article": "https://www.yahoo.com/news/world/articles/two-dead-26-injured-coach-074835373.html"
    },
    {
      "article": "Two dead, 26 injured after coach overturns in southern Germany"
    },
    {
      "article": "https://www.yahoo.com/news/politics/articles/iran-live-updates-saudi-foreign-080920533.html"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `tags` | array |  |  |
| `authors` | array |  |  |
| `section` | string or null | `"World"` |  |
| `summary` | string or null | `"Two people were killed and around 25 others slightly injured after a coach overturned on the A96 motorway in southern G` |  |
| `headline` | string | `"Two dead, 26 injured after coach overturns in southern Germany"` |  |
| `article_id` | string or null | `"9896c0e0-2b00-3f55-a7a0-4b6e8ca0635d"` |  |
| `paragraphs` | array |  |  |
| `updated_at` | string or null | `"2026-09-27T07:48:35+00:00"` | Last update date and time in ISO 8601 with offset. |
| `word_count` | integer | `276` |  |
| `article_link` | string | `"https://www.yahoo.com/news/world/articles/two-dead-26-injured-coach-074835373.html"` |  |
| `published_at` | string or null | `"2026-09-27T07:48:35+00:00"` | Publication date and time in ISO 8601 with offset. |
| `main_image_link` | string or null | `"https://s.yimg.com/lo/mysterio/api/ee8f294c347bea8620614753cb9cf181dd3058dc59e4cd170bae97ca44603c8b/lightyear_networkap` |  |
| `main_image_caption` | string or null | `"Emergency services and firefighters are on the scene near the southern German town of Buchloe, where a coach overturned` |  |
| `full_text_available` | boolean | `true` |  |

**Example input**

```json
{
  "article": "https://www.yahoo.com/news/world/articles/two-dead-26-injured-coach-074835373.html"
}
```

**Example output**

```json
{
  "tags": [
    "southern German",
    "police spokeswoman",
    "coach"
  ],
  "authors": [
    "DPA"
  ],
  "section": "World",
  "summary": "Two people were killed and around 25 others slightly injured after a coach overturned on the A96 motorway in southern Germany on Sunday, police told dpa. A police spokeswoman said one more person was …",
  "headline": "Two dead, 26 injured after coach overturns in southern Germany",
  "article_id": "9896c0e0-2b00-3f55-a7a0-4b6e8ca0635d",
  "paragraphs": [
    "Two people were killed and around 25 others slightly injured after a coach overturned on the A96 motorway in southern Germany on Sunday, police told dpa.",
    "A police spokeswoman said one more person was critically injured and in life-threatening condition. The number of injured could rise further.",
    "The accident occurred in the early morning at just before 6 am (0400 GMT) on the A96 motorway near the town of Buchloe in the eastern Allgäu district of Bavaria. It happened between the junctions to t…"
  ],
  "updated_at": "2026-09-27T07:48:35+00:00",
  "word_count": 276,
  "article_link": "https://www.yahoo.com/news/world/articles/two-dead-26-injured-coach-074835373.html",
  "published_at": "2026-09-27T07:48:35+00:00",
  "main_image_link": "https://s.yimg.com/lo/mysterio/api/ee8f294c347bea8620614753cb9cf181dd3058dc59e4cd170bae97ca44603c8b/lightyear_networkapi/resizefill_w1200%3Bquality_80%3Bformat_webp/https%3A%2F%2Fmedia.zenfs.com%2Fen%…",
  "main_image_caption": "Emergency services and firefighters are on the scene near the southern German town of Buchloe, where a coach overturned on the A96 motorway. (is associated with: «Two dead, 26 injured after coach over…",
  "full_text_available": true
}
```

### Search news

Operation `search_news`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Search Yahoo News articles by keyword, with optional publication dates, ordering and pages. Includes only articles hosted on Yahoo News; ordering and dates apply to a limited window of search results, so deeper matches may be missed.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | Page of matching articles to return, for example 1. |
| `sort` | string | no | `"most_relevant"` | Order articles by newest date or Yahoo search relevance; for example newest. |
| `query` | string | yes | `"Reuters"` | Words to search for, for example Tesla. |
| `to_date` | string | no | `"2026-09-29"` | Latest publication date, inclusive, for example 2026-09-29. |
| `from_date` | string | no | `"2026-09-01"` | Earliest publication date, inclusive, for example 2026-09-01. |
| `max_results` | integer | no | `3` | Articles per page, up to 50; for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page of matching articles to return, for example 1.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    },
    "sort": {
      "enum": [
        "newest",
        "most_relevant"
      ],
      "type": "string",
      "default": "newest",
      "description": "Order articles by newest date or Yahoo search relevance; for example newest.",
      "examples": [
        "most_relevant"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words to search for, for example Tesla.",
      "examples": [
        "Reuters",
        "Tesla"
      ]
    },
    "to_date": {
      "type": "string",
      "format": "date",
      "description": "Latest publication date, inclusive, for example 2026-09-29.",
      "examples": [
        "2026-09-29"
      ]
    },
    "from_date": {
      "type": "string",
      "format": "date",
      "description": "Earliest publication date, inclusive, for example 2026-09-01.",
      "examples": [
        "2026-09-01"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Articles per page, up to 50; for example 20.",
      "x-fous-developer": true,
      "examples": [
        3,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "page": 2,
      "sort": "most_relevant",
      "query": "Reuters",
      "max_results": 3
    },
    {
      "query": "Tesla",
      "max_results": 5
    },
    {
      "query": "Tesla",
      "to_date": "2026-09-29",
      "from_date": "2026-09-01",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `articles` | array |  |  |
| `articles[].link` | string | `"https://www.yahoo.com/news/politics/articles/trump-unveil-planned-15-billion-134434982.html"` |  |
| `articles[].authors` | array |  |  |
| `articles[].section` | string or null | `"Politics"` |  |
| `articles[].summary` | string or null | `"Sept 28 (Reuters) - US President Donald Trump on Monday said that a Minnesota company plans to build a multi-billion-do` |  |
| `articles[].headline` | string | `"Trump unveils $15 billion planned Iowa steel project"` |  |
| `articles[].published_at` | string or null | `"2026-09-28T20:41:28+00:00"` |  |
| `articles[].original_publisher` | string or null | `"Reuters"` |  |

**Example input**

```json
{
  "page": 2,
  "sort": "most_relevant",
  "query": "Reuters",
  "max_results": 3
}
```

**Example output**

```json
{
  "articles": [
    {
      "link": "https://www.yahoo.com/news/politics/articles/trump-unveil-planned-15-billion-134434982.html",
      "authors": [
        "By Jarrett Renshaw and Ernest Scheyder"
      ],
      "section": "Politics",
      "summary": "Sept 28 (Reuters) - US President Donald Trump on Monday said that a Minnesota company plans to build a multi-billion-dollar steel mill in Iowa, handing the administration a marquee manufacturing inves…",
      "headline": "Trump unveils $15 billion planned Iowa steel project",
      "published_at": "2026-09-28T20:41:28+00:00",
      "original_publisher": "Reuters"
    },
    {
      "link": "https://www.yahoo.com/news/articles/amsterdam-man-arrested-shinyhunters-hacking-175417471.html",
      "authors": [
        "By Raphael Satter, Anthony Deutsch and Andrew Goudsward"
      ],
      "section": null,
      "summary": "AMSTERDAM, Sept 28 (Reuters) - A Dutch man whose journey from cybercriminal to reformed security professional was widely covered in the international media has been arrested as part of an investigatio…",
      "headline": "Dutch 'reformed hacker' arrested in ShinyHunters investigation, police and ex-boss say",
      "published_at": "2026-09-28T23:34:38+00:00",
      "original_publisher": "Reuters"
    },
    {
      "link": "https://www.yahoo.com/news/politics/articles/analysis-trump-xis-stalemate-summit-092535051.html",
      "authors": [
        "By Mei Mei Chu, John Geddie and David Brunnstrom"
      ],
      "section": "Politics",
      "summary": "By Mei Mei Chu, John Geddie and David Brunnstrom BEIJING/TOKYO/WASHINGTON, Sept 28 (Reuters) - President Donald Trump hoped his pomp-filled summit with Xi Jinping in Washington last week would",
      "headline": "Trump and Xi's 'stalemate' summit was a glitzy gift to China",
      "published_at": "2026-09-28T23:39:39+00:00",
      "original_publisher": "Reuters"
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@yahoo-news",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "section": "US",
    "max_results": 5
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@yahoo-news\",\n  \"visibility\": \"public\",\n  \"operation\": \"list_headlines\",\n  \"version\": 1,\n  \"input\": {\n    \"section\": \"US\",\n    \"max_results\": 5\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@yahoo-news",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "section": "US",
    "max_results": 5
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/yahoo-news`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `list_headlines`: List headlines. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `read_article`: Read article. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_news`: Search news. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-yahoo-news https://api.fous.com/mcp/tools/yahoo-news --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Track headlines across selected news sections.
- Find Yahoo News articles about a topic.
- Review articles published within a date range.
- Read article text, authors, and publication details.
- Collect headlines, summaries, and publisher information.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Yahoo News tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Yahoo News account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from yahoo.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What are the latest headlines in a news section?

Use List headlines with the section name and an optional maximum number of results.

### Which Yahoo News articles mention a topic?

Use Search news with a keyword and optional dates, ordering, page, and result count.

### How can I read a Yahoo News article?

Use Read article with the article link or headline to return its text and details.

## Related

- [The New York Times API](https://fous.com/tools/the-new-york-times.md): The New York Times provides current section headlines and summaries, keyword-matched public listings with dates, authors, sections and links, and Best Sellers lists for the latest issue or dates within a week.
- [AP News API](https://fous.com/tools/ap-news.md): AP News provides reporting, up to 50 public-page headlines, searchable articles visible in its search, and full text when accessible.
- [Fox News API](https://fous.com/tools/fox-news.md): Fox News returns section-page headlines, keyword-matched articles among up to 100 available results, and readable article text, including the latest live-blog updates.
- [Reuters API](https://fous.com/tools/reuters.md): Reuters provides international news and reporting, with latest section headlines and keyword search; coverage and article details may be limited by access restrictions and news indexing.
- [NPR API](https://fous.com/tools/npr.md): NPR returns displayed section headlines, searchable articles with summaries and publication details, and available article text; date-filtered searches may miss older stories edited much later.
- [BBC News API](https://fous.com/tools/bbc-news.md): BBC News returns section-ordered headlines, searchable articles with dates, authors and sections (filters/newest sorting cover 180 matches), and article text with available latest live entries.
- [Google News API](https://fous.com/tools/google-news.md): Google News returns recent publisher articles, up to 100 per search, current top stories by topic, country, and language, and local stories by city or region when available.
- [The Wall Street Journal API](https://fous.com/tools/the-wall-street-journal.md): The Wall Street Journal provides news-section headlines and searchable public article headlines and summaries, with available story details and publication dates for search filtering.
- [All News tools](https://fous.com/tools/category/news)