# get_headlines

Recent press headlines about one company (headline, outlet, date, link; never article text), from The GDELT Project's news index, newest first.

- Group: More tools
- REST: `GET https://api.fundalyze.ai/api/public/v1/get_headlines` with the parameters as the query string
- MCP: the `get_headlines` tool on `https://api.fundalyze.ai/mcp`
- HTML page: https://fundalyze.ai/developers/reference/get_headlines

## Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `ticker` (required) | string (up to 12 characters) | — | US ticker symbol, e.g. AAPL or BRK-B. Use search_companies when unsure. |
| `limit` | integer (1–20) | 10 | Headlines to return, newest first, 1-20. |

## Example

REST:

```bash
curl -H "Authorization: Bearer fdz_live_YOUR_KEY" "https://api.fundalyze.ai/api/public/v1/get_headlines?ticker=MSFT&limit=5"
```

MCP `tools/call`:

```json
{
  "name": "get_headlines",
  "arguments": {
    "ticker": "MSFT",
    "limit": 5
  }
}
```

Response `text` (generated Oct 7, 2026):

```text
MSFT · press headlines · newest first · matched by company name, so a few may be about something else
published,source,title,url
2026-10-07T02:45:00+00:00,investors.com,"Microsoft Embraced AI Megatrend, Leads 9 To Best Stock Lists",https://www.investors.com:443/research/microsoft-leads-9-joining-ibd-best-stock-lists/
2026-10-06T23:15:00+00:00,cnbc.com,"Jim Cramer's AI stock picks: Meta, Microsoft and more",https://www.cnbc.com/2026/10/06/jim-cramer-ai-stocks.html
2026-10-06T18:30:00+00:00,fool.com,Not Microsoft. Not Google. Analysts Call This $2.7 Trillion Tech Titan the Most Undervalued AI Play.,https://www.fool.com/investing/2026/10/06/not-microsoft-not-google-the-2-trillion-tech-titan/?source=iedfolrf0000001
2026-10-05T20:15:00+00:00,cnbc.com,Wall Street rewards Microsoft's AI pivot. A longtime skeptic flips bullish,https://www.cnbc.com/investingclub/2026/10/05/wall-street-rewards-microsofts-ai-pivot-a-longtime-skeptic-flips-bullish.html
2026-10-05T19:45:00+00:00,seekingalpha.com,"Meta, Microsoft scale back employee use of Claude: report",https://seekingalpha.com/news/4650314-meta-microsoft-scale-back-employee-use-of-claude-report
Headlines via The GDELT Project (https://www.gdeltproject.org/)
More: https://fundalyze.ai/stocks/nasdaq/msft
```

Response `data`:

```json
{
  "ticker": "MSFT",
  "headlines": [
    {
      "title": "Microsoft Embraced AI Megatrend, Leads 9 To Best Stock Lists",
      "url": "https://www.investors.com:443/research/microsoft-leads-9-joining-ibd-best-stock-lists/",
      "source": "investors.com",
      "published": "2026-10-07T02:45:00+00:00"
    },
    {
      "title": "Jim Cramer's AI stock picks: Meta, Microsoft and more",
      "url": "https://www.cnbc.com/2026/10/06/jim-cramer-ai-stocks.html",
      "source": "cnbc.com",
      "published": "2026-10-06T23:15:00+00:00"
    },
    {
      "title": "Not Microsoft. Not Google. Analysts Call This $2.7 Trillion Tech Titan the Most Undervalued AI Play.",
      "url": "https://www.fool.com/investing/2026/10/06/not-microsoft-not-google-the-2-trillion-tech-titan/?source=iedfolrf0000001",
      "source": "fool.com",
      "published": "2026-10-06T18:30:00+00:00"
    },
    {
      "title": "Wall Street rewards Microsoft's AI pivot. A longtime skeptic flips bullish",
      "url": "https://www.cnbc.com/investingclub/2026/10/05/wall-street-rewards-microsofts-ai-pivot-a-longtime-skeptic-flips-bullish.html",
      "source": "cnbc.com",
      "published": "2026-10-05T20:15:00+00:00"
    },
    {
      "title": "Meta, Microsoft scale back employee use of Claude: report",
      "url": "https://seekingalpha.com/news/4650314-meta-microsoft-scale-back-employee-use-of-claude-report",
      "source": "seekingalpha.com",
      "published": "2026-10-05T19:45:00+00:00"
    }
  ],
  "attribution": {
    "name": "The GDELT Project",
    "url": "https://www.gdeltproject.org/"
  }
}
```

## The link

Every answer ends with `More: <link>`, and REST returns the same URL as `link`: the fundalyze.ai page where the figures can be checked. Cite it when you show the data to others.