# Yahoo API: Get company news

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

Unofficial. Not affiliated with or endorsed by Yahoo.

- Page: https://fous.com/methods/finance.yahoo.com/get-company-news
- Method: `finance.yahoo.com/get_company_news`, version 1
- Website: finance.yahoo.com
- Returns: company name, ticker, and articles with headline, publisher, published time, summary, thumbnail, article URL, related tickers
- 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 |
|---|---|---|---|---|
| `company` | string | yes | `"Microsoft"` | Company name or ticker, for example Tesla or TSLA. |
| `max_results` | integer | no |  | Maximum articles to return, for example 10; up to 50. Default 10. |

## Output

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

```json
{
  "company": "Microsoft"
}
```

Its output:

```json
{
  "ticker": "MSFT",
  "articles": [
    {
      "summary": "Investors will now turn their attention to next week’s reports from Microsoft, Alphabet, Amazon and Intel for fresh clues.",
      "headline": "Stocktwits AI Roundup: Meta’s Capex, Lam’s Supply Warning Hit Tech Stocks As Netflix Disappoints",
      "publisher": "Stocktwits",
      "article_url": "https://finance.yahoo.com/technology/articles/stocktwits-ai-roundup-meta-capex-060151706.html",
      "published_at": "2026-10-23T06:01:51+00:00",
      "thumbnail_url": "https://media.zenfs.com/en/stocktwits_383/4ffb5f785cf1fb247352995d330ac66b.jpg",
      "related_tickers": [
        "META",
        "NFLX",
        "LRCX"
      ],
      "yahoo_article_id": "cf20f61b-d37c-3900-aefd-dae791df3622"
    },
    {
      "summary": "Forget the quantum computing pure plays -- Microsoft is in a unique position in this space.",
      "headline": "Not IonQ. Not D-Wave. This Quantum Stock Could Be 2027's Surprise Winner.",
      "publisher": "Motley Fool",
      "article_url": "https://finance.yahoo.com/technology/ai/articles/not-ionq-not-d-wave-052000521.html",
      "published_at": "2026-10-23T05:20:00+00:00",
      "thumbnail_url": "https://media.zenfs.com/en/motleyfool.com/cce177fe33388e29026baa91fbfcd1ed.jpg",
      "related_tickers": [
        "MSFT",
        "NVDA",
        "IONQ"
      ],
      "yahoo_article_id": "be67458e-d4cd-34b2-aa82-e247e4f8f881"
    },
    {
      "summary": "The biggest tech stocks have handed the baton as leadership has firmly shifted toward other S&P 500 sectors and industries.",
      "headline": "S&P 500 best performers: Zero mag 7 stocks past 13 weeks",
      "publisher": "TheStreet",
      "article_url": "https://finance.yahoo.com/markets/stocks/articles/p-500-best-performers-zero-040300672.html",
      "published_at": "2026-10-23T04:03:00+00:00",
      "thumbnail_url": "https://media.zenfs.com/en/thestreet_881/544bd44ecd470d9b72051d5bf3ec31e9.jpg",
      "related_tickers": [
        "TSLA",
        "META",
        "AMZN"
      ],
      "yahoo_article_id": "bb672730-d2cc-37a0-8475-0b2bb1b342b0"
    }
  ],
  "company_name": "Microsoft Corporation"
}
```

## 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":"finance.yahoo.com/get_company_news","input":{"company":"Microsoft"}}'
```

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

- What are the latest headlines about Tesla stock today?
- Pull up the 8 most recent news articles on NVDA with publisher names and links.
- Can you find recent news coverage for Apple Inc. from Yahoo Finance, including short article summaries?
- I need the newest 20 stories about Microsoft and its ticker MSFT, with thumbnails and related tickers.
- Give me a quick rundown of what's been reported lately about Amazon, limited to 5 articles.

## Input schema

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "minLength": 1,
      "description": "Company name or ticker, for example Tesla or TSLA."
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum articles to return, for example 10; up to 50."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "company_name",
    "ticker",
    "articles"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Matched Yahoo Finance ticker."
    },
    "articles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "headline",
          "publisher",
          "published_at",
          "summary",
          "thumbnail_url",
          "article_url",
          "related_tickers",
          "yahoo_article_id"
        ],
        "properties": {
          "summary": {
            "type": [
              "string",
              "null"
            ],
            "description": "Short plain-text article description; null if not available."
          },
          "headline": {
            "type": "string"
          },
          "publisher": {
            "type": [
              "string",
              "null"
            ]
          },
          "article_url": {
            "type": "string"
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Publication date and time in ISO 8601 with offset."
          },
          "thumbnail_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "related_tickers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "yahoo_article_id": {
            "type": "string"
          }
        }
      },
      "description": "Recent news articles, newest first."
    },
    "company_name": {
      "type": "string",
      "description": "Matched company name."
    }
  }
}
```

## 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: 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 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: 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 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.
- [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: 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 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)
