# Yahoo API: Search Yahoo News

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

Unofficial. Not affiliated with or endorsed by Yahoo.

- Page: https://fous.com/methods/yahoo.com/search-news
- Method: `yahoo.com/search_news`, version 1
- Website: yahoo.com
- Returns: headline, summary, published time, authors, original publisher, section, 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
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `page` | integer | no |  | Page of matching articles to return, for example 1. Default 1. |
| `sort` | string | no |  | Order articles by newest date or Yahoo search relevance; for example newest. One of "newest", "most_relevant". Default "newest". |
| `query` | string | yes | `"Tesla"` | Words to search for, for example Tesla. |
| `to_date` | string | no |  | Latest publication date (YYYY-MM-DD), inclusive, for example 2026-09-29. |
| `from_date` | string | no |  | Earliest publication date (YYYY-MM-DD), inclusive, for example 2026-09-01. |
| `max_results` | integer | no | `5` | Articles per page, up to 50; for example 20. Default 20. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "query": "Tesla",
  "max_results": 5
}
```

Its output:

```json
{
  "articles": [
    {
      "link": "https://www.yahoo.com/news/us/articles/tesla-driver-iphone-called-911-220000610.html",
      "authors": [
        "John Lloyd"
      ],
      "section": "U.S.",
      "summary": "A Tesla hit a light pole and two trees inside the Miromar Lakes community in... The post A Tesla Driver’s iPhone Called 911 on Its Own After He Crashed. Deputies Say He Didn’t Stick Around. appeared f...",
      "headline": "A Tesla Driver’s iPhone Called 911 on Its Own After He Crashed. Deputies Say He Didn’t Stick Around.",
      "published_at": "2026-09-28T22:00:00+00:00",
      "original_publisher": "The Auto Wire"
    },
    {
      "link": "https://www.yahoo.com/news/us/articles/texas-man-defrauded-tricare-26-213251683.html",
      "authors": [
        "Patricia Kime"
      ],
      "section": "U.S.",
      "summary": "A Texas man used money defrauded from Tricare for a casino-themed party and a gold-plated Tesla Cybertruck, among other expenses.",
      "headline": "Texas man defrauded Tricare of $26 million to fund lavish lifestyle",
      "published_at": "2026-09-28T21:32:51+00:00",
      "original_publisher": "Military Times"
    },
    {
      "link": "https://www.yahoo.com/news/us/articles/man-sentenced-fatally-shooting-man-202239010.html",
      "authors": [
        "Robert Locklear"
      ],
      "section": "U.S.",
      "summary": "A man has been sentenced to prison for shooting and killing a man outside his car in Fairfax County in 2025.",
      "headline": "Man sentenced for fatally shooting man who kicked his Tesla in Fairfax County",
      "published_at": "2026-09-28T20:22:39+00:00",
      "original_publisher": "DC News Now Washington"
    }
  ]
}
```

## 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/search_news","input":{"query":"Tesla","max_results":5}}'
```

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

- Find the latest news articles about Nvidia earnings, newest first, and show me who wrote each one and the original publisher.
- Search Yahoo News for stories on the Federal Reserve interest rate decision published between 2025-06-10 and 2025-06-20, sorted by relevance.
- Pull 40 recent articles mentioning Boeing 737 MAX, including headline, summary, section and link.
- I need page 2 of Yahoo News results for 'housing market mortgage rates', most relevant first, 25 per page.
- Get news coverage of the Microsoft Activision deal from March 1 to March 31, 2025, with authors and publication times.

## 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."
    },
    "sort": {
      "enum": [
        "newest",
        "most_relevant"
      ],
      "type": "string",
      "default": "newest",
      "description": "Order articles by newest date or Yahoo search relevance; for example newest."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words to search for, for example Tesla."
    },
    "to_date": {
      "type": "string",
      "description": "Latest publication date (YYYY-MM-DD), inclusive, for example 2026-09-29."
    },
    "from_date": {
      "type": "string",
      "description": "Earliest publication date (YYYY-MM-DD), inclusive, for example 2026-09-01."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Articles per page, up to 50; for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "articles"
  ],
  "properties": {
    "articles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "headline",
          "summary",
          "published_at",
          "authors",
          "original_publisher",
          "section",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string"
          },
          "authors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "section": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "headline": {
            "type": "string"
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "original_publisher": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [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.
- [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: 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 quote](https://fous.com/methods/finance.yahoo.com/get-quote.md): Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed.
- [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 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 price history](https://fous.com/methods/finance.yahoo.com/get-price-history.md): Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency.
- [All Yahoo methods](https://fous.com/methods/yahoo.com.md)
