Skip to main content
GET
/
v1
/
news
Python (SDK)
from finance_dev import FinanceDev, models
import os


with FinanceDev(
    security=models.Security(
        client_id=os.getenv("FINANCEDEV_CLIENT_ID", ""),
        client_secret=os.getenv("FINANCEDEV_CLIENT_SECRET", ""),
    ),
) as fd_client:

    res = fd_client.news.get_news(symbols="AAPL,GOOGL,MSFT", topics="earnings,guidance")

    # Handle response
    print(res)
{
  "articles": [
    {
      "id": "news_abc123",
      "title": "Apple Reports Record Q4 Earnings",
      "summary": "Apple Inc. announced record-breaking fourth quarter earnings, surpassing analyst expectations with strong iPhone sales.",
      "url": "https://financialnews.com/apple-q4-earnings",
      "source": "Financial News Daily",
      "author": "John Smith",
      "published_at": "2024-01-15T14:30:00Z",
      "symbols": [
        "AAPL"
      ],
      "category": "earnings",
      "sentiment": "positive",
      "image_url": "https://cdn.financialnews.com/apple-earnings.jpg"
    },
    {
      "id": "news_def456",
      "title": "Tech Sector Shows Strong Growth",
      "summary": "Major technology companies continue to demonstrate robust growth amid market volatility.",
      "url": "https://financialnews.com/tech-sector-growth",
      "source": "Market Watch",
      "author": "Jane Doe",
      "published_at": "2024-01-15T13:00:00Z",
      "symbols": [
        "AAPL",
        "GOOGL",
        "MSFT",
        "NVDA"
      ],
      "category": "technology",
      "sentiment": "positive",
      "image_url": "https://cdn.marketwatch.com/tech-growth.jpg"
    }
  ],
  "total": 150,
  "limit": 20,
  "offset": 0
}

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:20

Maximum number of news articles to return

Required range: 1 <= x <= 100
Example:

20

offset
integer
default:0

Number of articles to skip for pagination

Required range: x >= 0
Example:

0

symbols
string

Comma-separated list of stock symbols to filter news

Example:

"AAPL,GOOGL,MSFT"

category
enum<string>

News category filter

Available options:
market,
earnings,
economy,
technology,
healthcare,
energy,
finance
Example:

"technology"

from_date
string<date-time>

Start date for news articles (ISO 8601 format)

Example:

"2024-01-01T00:00:00Z"

to_date
string<date-time>

End date for news articles (ISO 8601 format)

Example:

"2024-12-31T23:59:59Z"

Response

News retrieved successfully

articles
object[]
total
integer

Total number of articles available

limit
integer

Number of articles per page

offset
integer

Current pagination offset