get_headlines | Fundalyze API docs

RESTGET https://api.fundalyze.ai/api/public/v1/get_headlinesMCPget_headlines

Parameters

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

Example

A real call and its answer. Replace fdz_live_YOUR_KEY with your key, or set FUNDALYZE_API_KEY for the Python and JavaScript versions.

get_headlines: curl

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

get_headlines: Python

import os

import requests

response = requests.get(
    "https://api.fundalyze.ai/api/public/v1/get_headlines",
    params={
        "ticker": "MSFT",
        "limit": 5,
    },
    headers={"Authorization": f"Bearer {os.environ['FUNDALYZE_API_KEY']}"},
    timeout=60,
)
response.raise_for_status()
answer = response.json()
print(answer["text"])
print("Calls left today:", response.headers.get("X-Quota-Remaining"))

get_headlines: JavaScript

const params = new URLSearchParams()
params.append("ticker", "MSFT")
params.append("limit", "5")

const response = await fetch(`https://api.fundalyze.ai/api/public/v1/get_headlines?${params}`, {
  headers: { Authorization: `Bearer ${process.env.FUNDALYZE_API_KEY}` },
})
const answer = await response.json()
if (!response.ok) throw new Error(`${response.status}: ${answer.detail}`)
console.log(answer.text)
console.log('Calls left today:', response.headers.get('X-Quota-Remaining'))

get_headlines: MCP

The same call as an MCP tools/call: what an assistant sends.

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

Response

Generated from live data on Oct 7, 2026; figures change as filings arrive.

get_headlines: response text

What an assistant reads (and what MCP returns).

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

get_headlines: response data

The same content as JSON (REST).

{
  "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/"
  }
}

Fields of data

What each field of data means. rows[].field is a field of each row in the rows list.

Field	Meaning
`ticker`	The ticker as listed in the SEC EDGAR directory, upper case.
`headlines`	Press headlines matched to the company by name, newest first, one per distinct title.
`headlines[].title`	The headline as published.
`headlines[].url`	Link to the article on the publisher's site.
`headlines[].source`	The publishing outlet's domain.
`headlines[].published`	When The GDELT Project indexed the article (ISO timestamp, UTC).
`attribution`	Who to credit when you show headlines: {name, url} of The GDELT Project.

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 (here, fundalyze.ai/stocks/nasdaq/msft). Cite it when you show the data to others, as the attribution rules ask.

Errors

A bad parameter is a 400 naming it, an unknown ticker a 404, a busy key or a used-up day a 429. Every status and message: Errors.

This page as Markdown, for language models and scripts: /developers/md/reference/get_headlines