News

Retrieve News Feed

GET https://api.main.finalle.ai/news

Get a real-time feed of financial news (descending ordered by timestamp).

Headers

Include the X-API-Keyheader in order to authenticate:

{  
    "X-API-Key": "YOUR_API_KEY"
}

Path Parameters

Name
Type
Description

symbols

String

A comma separated list of symbols to query, maximum is 10 symbols. Defaults to all available symbols. If provided, only news relating these (system's supported) symbols will be returned. If non of the provided symbols is supported, an empty feed list will be returned.

limit

Integer

Limit the number of results returned. Defaults to 10, max is 100.

from

Date

The start date to retrieve feed news from, in ISO format (YYYY-MM-DDTHH:MM:SS). Defaults to 2 weeks ago, minimum date is 1 month ago.

to

Date

The end date to retrieve feed news from, in ISO format (YYYY-MM-DDTHH:MM:SS). Defaults to current time, minimum date is 1 month ago.

On success, returns a news feed (a list of JSON objects), where each item is a news item object. The output follows the following structure:

{
  "data": {
    "news": [
      {
        "symbol": "string",  // The main symbol associated with the news
        "timestamp": "string",  // The timestamp of the news article, in YYYY-MM-DDTHH:MM:SS format
        "url": "string",  // The URL of the news article
        "title": "string",  // The title of the news article
        "text": "string",  // The content or excerpt of the news article
        "author_profile_image_url": "string",  // The URL of the author's profile image
        "author": "string"  // The name of the author or publisher of the news article
      }
    ]
  },
  "request_id": "YOUR_REQUEST_ID", 
  "result": "success"
}

Example

For the request:

https://api.main.finalle.ai/news?limit=25&symbols=TSLA,AAPL,NVDA,MSFT

The output is:

Last updated