> ## Documentation Index
> Fetch the complete documentation index at: https://docs.financialdatasets.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Company News
> Get the latest news articles and press coverage for any US public company by stock ticker.
### 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 from public RSS feeds.
Market news covers AI, macro, rates, earnings, geopolitics, energy, crypto, and other market-moving topics.
To get started, please create an account and grab your API key at [financialdatasets.ai](https://financialdatasets.ai).
You will use the API key to authenticate your API requests.
### Coverage
| Tickers | Years of Coverage | Updated |
| ------- | ----------------- | ----------------- |
| 10,000+ | 2+ years | Within 10 minutes |
### 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
```python Company News theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
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')
```
```python Market News theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import requests
# add your API key to the headers
headers = {
"X-API-KEY": "your_api_key_here"
}
# omit ticker to get broad market news
limit = 10
# create the URL
url = (
f'https://api.financialdatasets.ai/news'
f'?limit={limit}'
)
# make API request
response = requests.get(url, headers=headers)
# parse market news from the response
news = response.json().get('news')
```
## OpenAPI
````yaml GET /news
openapi: 3.0.1
info:
title: Financial Datasets API
description: >-
Stock market API with real-time and historical financial data for 27,000+
tickers over 30+ years. Financial statements, equity prices, insider trades,
SEC filings, and more.
version: 1.0.0
license:
name: MIT
url: https://opensource.org/licenses/MIT
contact:
name: API Support
url: mailto:support@financialdatasets.ai
email: support@financialdatasets.ai
termsOfService: https://financialdatasets.ai/terms-of-use
servers:
- url: https://api.financialdatasets.ai/
description: Production server
security:
- X-API-KEY: []
tags:
- name: Financial Statements
description: Access to income statements, balance sheets, and cash flow statements
- name: Market Data
description: Real-time and historical price data
- name: Company Information
description: Company facts like ticker, name, and description
- name: Earnings
description: Earnings data and related information
- name: News
description: Real-time and historical news articles
- name: SEC Filings
description: SEC filings and regulatory documents
- name: Insider Trades
description: Insider trading activity and transactions
- name: Activist Ownership
description: Activist stakes from SEC Schedule 13D filings, in real time
- name: Beneficial Ownership
description: >-
Holders of more than 5% of a company's shares, from SEC Schedules 13D and
13G
- name: Insider Ownership
description: Insider ownership statements from SEC Forms 3 and 5
- name: Institutional Holdings
description: SEC-direct 13F equity holdings of institutional investment managers
- name: Index Funds
description: >-
ETF and index-fund holdings, weights, and the funds that hold a given
security
- name: Financial Metrics
description: Financial ratios, metrics, and key performance indicators
- name: Macroeconomics
description: Real-time and historical macroeconomic data like interest rates
- name: KPIs
description: Sector-specific operational KPIs extracted from earnings releases.
paths:
/news:
get:
tags:
- News
summary: Get news articles
description: >-
Get recent news articles for a specific company or the broad market.
Pass a ticker for company-specific news, or omit the ticker for general
market news. Articles are sourced from RSS feeds of publishers like The
Motley Fool, Investing.com, Reuters, and more.
operationId: getNews
parameters:
- name: ticker
in: query
description: The ticker symbol of the company. Omit for broad market news.
required: false
schema:
type: string
- name: limit
in: query
description: 'The maximum number of news articles to return (default: 5, max: 10).'
required: false
schema:
type: integer
default: 5
maximum: 10
responses:
'200':
description: News articles response
content:
application/json:
schema:
$ref: '#/components/schemas/NewsResponse'
'400':
$ref: '#/components/responses/BadRequestError'
'401':
$ref: '#/components/responses/UnauthorizedError'
'402':
$ref: '#/components/responses/PaymentRequiredError'
'404':
$ref: '#/components/responses/NotFoundError'
components:
schemas:
NewsResponse:
type: object
properties:
news:
type: array
items:
$ref: '#/components/schemas/News'
News:
type: object
properties:
ticker:
type: string
description: The ticker symbol.
title:
type: string
description: The title of the news article.
source:
type: string
description: The source of the news article.
date:
type: string
format: date
description: The date the news article was published.
url:
type: string
format: uri
description: The URL of the news article.
ErrorResponse:
type: object
properties:
error:
type: string
description: A short error message.
message:
type: string
description: A more detailed error message.
responses:
BadRequestError:
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
message: Invalid request parameters
UnauthorizedError:
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Unauthorized
message: Invalid API key provided
PaymentRequiredError:
description: The request requires a paid subscription
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment Required
message: >-
This endpoint requires a paid subscription. Please upgrade your
plan.
NotFoundError:
description: The specified resource was not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Not Found
message: Ticker XXXX not found
securitySchemes:
X-API-KEY:
type: apiKey
name: X-API-KEY
description: API key for authentication.
in: header
````