Skip to main content
GET
/
news
Get news articles
curl --request GET \
  --url https://api.financialdatasets.ai/news \
  --header 'X-API-KEY: <api-key>'
{
  "news": [
    {
      "ticker": "<string>",
      "title": "<string>",
      "source": "<string>",
      "date": "2023-12-25",
      "url": "<string>"
    }
  ]
}

​
Overview

The News API lets you pull recent news articles for a given ticker, or broad market news when no ticker is provided. Our news articles are sourced directly from publishers like The Motley Fool, Investing.com, Reuters, and more. Market news covers macro, rates, earnings, geopolitics, energy, crypto, and other market-moving topics. We are actively adding more publishers to our network. If you have a publisher that you would like us to add, please email us at [email protected]. To get started, please create an account and grab your API key at financialdatasets.ai. You will use the API key to authenticate your API requests.

​
Getting Started

There are only 3 steps for making a successful API call:
  1. Add your API key to the header of the request as X-API-KEY.
  2. Add the ticker query param to get company-specific news, or omit it for broad market news. Optionally add limit to control the number of results.
  3. Execute the API request.

​
Examples

import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'AAPL'
limit = 5  # optional, max is 10

# create the URL
url = (
    f'https://api.financialdatasets.ai/news'
    f'?ticker={ticker}'
    f'&limit={limit}'
)

# make API request
response = requests.get(url, headers=headers)

# parse news from the response
news = response.json().get('news')

Authorizations

​
X-API-KEY
string
header
required

API key for authentication.

Query Parameters

​
ticker
string

The ticker symbol of the company. Omit for broad market news.

​
limit
integer
default:5

The maximum number of news articles to return (default: 5, max: 10).

Required range: x <= 10

Response

News articles response

​
news
object[]