# Yahoo API: List Yahoo News headlines

> 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.

Unofficial. Not affiliated with or endorsed by Yahoo.

- Page: https://fous.com/methods/yahoo.com/list-headlines
- Method: `yahoo.com/list_headlines`, version 1
- Website: yahoo.com
- Returns: headline, summary, published_at, authors, original_publisher, section, image_link, article_link
- 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 | `"politics"` | News section to list, for example world. One of "top stories", "US", "world", "politics", "health", "science". Default "top stories". |
| `max_results` | integer | no | `3` | Maximum number of headlines to return, for example 20. Default 20. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "section": "politics",
  "max_results": 3
}
```

Its output:

```json
{
  "stories": []
}
```

## 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":"yahoo.com/list_headlines","input":{"section":"politics","max_results":3}}'
```

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 world news headlines with summaries and publishers, up to 15 items.
- What are today's top stories on Yahoo News? Include bylines and publication times.
- Give me 25 recent health headlines with their original publishers and article links.
- I need the newest politics headlines in page order, including images if available.
- Pull up the latest science news stories from the US section, limited to 10 results.

## 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."
    },
    "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",
          "original_publisher",
          "section",
          "image_link",
          "article_link"
        ],
        "properties": {
          "authors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "section": {
            "type": "string"
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "headline": {
            "type": "string"
          },
          "image_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "article_link": {
            "type": "string"
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Publication date and time with UTC offset, or null when unavailable."
          },
          "original_publisher": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Yahoo API: Search Yahoo News](https://fous.com/methods/yahoo.com/search-news.md): Searches Yahoo News articles by keyword, newest first or by relevance, with optional publication dates and pages; returns only articles hosted on Yahoo News, with authors, original publisher and section.
- [Yahoo API: Get company news](https://fous.com/methods/finance.yahoo.com/get-company-news.md): Looks up a company by name or ticker on Yahoo Finance and returns its latest news headlines, with article summaries when the article page provides one.
- [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.
- [Yahoo API: List market movers](https://fous.com/methods/finance.yahoo.com/list-market-movers.md): Lists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap.
- [Yahoo API: Get earnings calendar](https://fous.com/methods/finance.yahoo.com/get-earnings-calendar.md): Gets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company.
- [Yahoo API: Get scores](https://fous.com/methods/sports.yahoo.com/get-scores.md): Gets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games.
- [Yahoo API: Get team standings](https://fous.com/methods/sports.yahoo.com/get-standings.md): Returns Yahoo Sports team standings for a league and season, grouped by division or conference.
- [Yahoo API: Get analyst ratings](https://fous.com/methods/finance.yahoo.com/get-analyst-ratings.md): Shows analyst recommendations, price targets, earnings estimates and recent rating changes for a public company on Yahoo Finance.
- [All Yahoo methods](https://fous.com/methods/yahoo.com.md)