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:
{
"data": {
"news": [
{
"author": "CNET",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434908916x448652775717659260/image_CNET.png",
"symbol": "MSFT",
"text": "You can get your hands on a lifetime license to Microsoft Office Professional Plus 2019 on your PC for only $25.",
"timestamp": "2024-06-27T14:11:00",
"title": "Score Microsoft Office for Windows or Mac for Nearly 90% Off - CNET",
"url": "https://www.cnet.com/deals/score-microsoft-office-for-windows-or-mac-for-nearly-90-off/"
},
{
"author": "MacDailyNews",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434894529x697246597650502640/image_MacDailyNews.png",
"symbol": "AAPL",
"text": "Apple TV+ today unveiled a first look at the fourth season of its award-winning espionage series “Slow Horses,” starring Gary Oldman as…",
"timestamp": "2024-06-27T14:01:36",
"title": "Apple TV+ series ‘Slow Horses,’ starring Gary Oldman, returns for season four on September 4th - MacDailyNews",
"url": "https://macdailynews.com/2024/06/27/apple-tv-series-slow-horses-starring-gary-oldman-returns-for-season-four-on-september-4th/"
},
{
"author": "The Verge",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434364760x765660464717085400/image_The_Verge.png",
"symbol": "MSFT",
"text": "The Xbox TV app will stream games to Fire TV Sticks.",
"timestamp": "2024-06-27T14:00:00",
"title": "Xbox Cloud Gaming is coming to Amazon's Fire TV Sticks in July - The Verge",
"url": "https://www.theverge.com/2024/6/27/24187164/xbox-cloud-gaming-tv-app-fire-tv-stick-amazon-launch"
},
{
"author": "InvestorPlace",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434102081x945839080534312800/image_InvestorPlace.png",
"symbol": "NVDA",
"text": "Nvidia's CEO addressed concerns about the company's competition, as NVDA stock has struggled to advance in the last several days. ",
"timestamp": "2024-06-27T13:50:07",
"title": "NVDA Stock: CEO Jensen Huang Says Nvidia Has a Plan for Competition - InvestorPlace",
"url": "https://investorplace.com/2024/06/nvda-stock-ceo-jensen-huang-says-nvidia-has-a-plan-for-competition/"
},
{
"author": "Times Now",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713435602258x648203228788374800/image_Times_Now.png",
"symbol": "MSFT",
"text": "Microsoft's AI chief, Mustafa Suleyman, aims to transform Copilot into a personalized assistant that remembers everything about users, offering constant support and companionship., Technology & Science News - Times Now",
"timestamp": "2024-06-27T13:27:15",
"title": "Microsoft's Copilot Aims To Become Your Personal Memory, Says AI Chief Suleyman - Times Now",
"url": "https://www.timesnownews.com/technology-science/microsofts-copilot-aims-to-become-your-personal-memory-says-ai-chief-suleyman-article-111317947"
},
{
"author": "The Motley Fool",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434083527x133032435461362340/image_The_Motley_Fool_20_281_29.png",
"symbol": "NVDA",
"text": "The Blackwell chip will be one of Nvidia's most significant products, but there is more.",
"timestamp": "2024-06-27T13:18:52",
"title": "Nvidia's CEO Just Said This About Its Upcoming Artificial Intelligence (AI) Chip, Blackwell - The Motley Fool",
"url": "https://www.fool.com/investing/2024/06/27/nvidias-ceo-just-said-this-about-its-upcoming-arti/"
},
{
"author": "MacDailyNews",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434894529x697246597650502640/image_MacDailyNews.png",
"symbol": "AAPL",
"text": "Is Apple a better once-in-a-generation investment opportunity than Nvidia right now? No rule says a company can't have multiple…",
"timestamp": "2024-06-27T13:08:19",
"title": "The better once-in-a-generation investment opportunity: Apple or Nvidia? - MacDailyNews",
"url": "https://macdailynews.com/2024/06/27/the-better-once-in-a-generation-investment-opportunity-apple-or-nvidia/"
},
{
"author": "MacDailyNews",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434894529x697246597650502640/image_MacDailyNews.png",
"symbol": "NVDA",
"text": "Is Apple a better once-in-a-generation investment opportunity than Nvidia right now? No rule says a company can't have multiple…",
"timestamp": "2024-06-27T13:08:19",
"title": "The better once-in-a-generation investment opportunity: Apple or Nvidia? - MacDailyNews",
"url": "https://macdailynews.com/2024/06/27/the-better-once-in-a-generation-investment-opportunity-apple-or-nvidia/"
},
{
"author": "Macworld",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713435253039x945085158601493600/image_Macworld.png",
"symbol": "AAPL",
"text": "Report claims bands will stay compatible with earlier models.",
"timestamp": "2024-06-27T13:06:00",
"title": "Apple Watch Series 10 leak shows off an Ultra-sized screen in a slim body - Macworld",
"url": "https://www.macworld.com/article/2379115/apple-watch-series-10-leak-ultra-display-small-body.html"
},
{
"author": "The Motley Fool",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434083527x133032435461362340/image_The_Motley_Fool_20_281_29.png",
"symbol": "TSLA",
"text": "The EV leader's soon-to-be built AI supercluster could give it the computing power it requires to achieve its ambitious goals.",
"timestamp": "2024-06-27T13:05:00",
"title": "Tesla Is Making Big Moves in the Artificial Intelligence (AI) Sector. Here's Why Investors Should Buy Now Before It's Too ... - The Motley Fool",
"url": "https://www.fool.com/investing/2024/06/27/tesla-is-making-big-moves-in-the-artificial-intell/"
},
{
"author": "BNN Bloomberg",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713435845229x707923631322998400/image_BNN_Bloomberg.png",
"symbol": "NVDA",
"text": "Big swings in Nvidia Corp. shares have reignited debate about the staying power of the chipmaker’s rally. While the stock’s valuation and threat of competition are major concerns, one variable is key: durability of demand.",
"timestamp": "2024-06-27T12:34:42",
"title": "Nvidia’s Wild Stock Swings Put AI Rally Stamina in Spotlight - BNN Bloomberg",
"url": "https://www.bnnbloomberg.ca/nvidia-s-wild-stock-swings-put-ai-rally-stamina-in-spotlight-1.2090302"
},
{
"author": "Seeking Alpha",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434064046x736626061620481800/image_Seeking_Alpha.png",
"symbol": "AAPL",
"text": "Apple's (AAPL) services business has become important, not only for its recurring revenue, but the impact it has on gross margins. Read for more.",
"timestamp": "2024-06-27T12:31:28.853000",
"title": "Apple's services could continue boosting company margins: Bernstein (AAPL)",
"url": "https://seekingalpha.com/news/4119991-apples-services-could-continue-boosting-company-margins-bernstein?source=content_type%3Areact%7Cfirst_level_url%3Amarket-news%7Csection_asset%3Amain"
},
{
"author": "Seeking Alpha",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434064046x736626061620481800/image_Seeking_Alpha.png",
"symbol": "AAPL",
"text": "Financial writer warns of risks in Apple stock rally driven by AI hype, predicting -45% downside.",
"timestamp": "2024-06-27T12:30:09.794000",
"title": "Apple: AI Euphoria Is A Selling Opportunity (NASDAQ:AAPL)",
"url": "https://seekingalpha.com/article/4701266-apple-stock-ai-euphoria-selling-opportunity?source=feed_all_articles"
},
{
"author": "India Today",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434465340x727619029504291500/image_India_Today.png",
"symbol": "MSFT",
"text": "Microsoft's AI chief Mustafa Suleyman, envisions Copilot as a personalised sidekick for users. With plans to enhance its memory and personalisation, Suleyman aims to elevate Microsoft's standing in Silicon Valley.",
"timestamp": "2024-06-27T12:26:17",
"title": "Microsoft wants Copilot to remember everything about users and become sidekick, says AI chief Suleyman - India Today",
"url": "https://www.indiatoday.in/technology/news/story/microsoft-wants-copilot-to-remember-everything-about-users-and-become-sidekick-says-ai-chief-suleyman-2559121-2024-06-27"
},
{
"author": "India Today",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434465340x727619029504291500/image_India_Today.png",
"symbol": "MSFT",
"text": "Microsoft's AI chief Mustafa Suleyman, envisions Copilot as a personalised sidekick for users. With plans to enhance its memory and personalisation, Suleyman aims to elevate Microsoft's standing in Silicon Valley.",
"timestamp": "2024-06-27T12:26:17",
"title": "Microsoft wants Copilot to remember everything about users and become sidekick, says AI chief Suleyman - India Today",
"url": "https://www.indiatoday.in/amp/technology/news/story/microsoft-wants-copilot-to-remember-everything-about-users-and-become-sidekick-says-ai-chief-suleyman-2559121-2024-06-27"
},
{
"author": "The Motley Fool",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434083527x133032435461362340/image_The_Motley_Fool_20_281_29.png",
"symbol": "NVDA",
"text": "One is a hot AI hardware play and the other is benefiting from the growing demand for AI software.",
"timestamp": "2024-06-27T12:26:07",
"title": "Better Artificial Intelligence (AI) Stock: Nvidia vs. Palantir Technologies - The Motley Fool",
"url": "https://www.fool.com/investing/2024/06/27/artificial-intelligence-ai-stock-nvidia-palantir/"
},
{
"author": "CNBC",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434116159x363321206857750460/image_CNBC.png",
"symbol": "NVDA",
"text": "Here are Thursday's biggest calls on Wall Street.",
"timestamp": "2024-06-27T12:11:24",
"title": "Thursday's top stocks to watch like Nvidia & Micron - CNBC",
"url": "https://www.cnbc.com/2024/06/27/thursdays-top-stocks-to-watch-like-nvidia-micron.html"
},
{
"author": "The Hindu",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713435464461x961618778683669400/image_The_Hindu.png",
"symbol": "AAPL",
"text": "Amazon has crossed the $2 trillion in valuation after investors pushed up its stock market value past the benchmark into an elite club.",
"timestamp": "2024-06-27T12:06:00",
"title": "Today’s Cache | Amazon crosses $2 trillion in valuation; Apple supplier Foxconn said to reject married women from jobs; YouTube in talks with labels to license songs - The Hindu",
"url": "https://www.thehindu.com/sci-tech/technology/todays-cache-amazon-crosses-2-trillion-in-value-apple-supplier-foxconn-said-to-reject-married-women-from-jobs-youtube-in-talks-with-labels-to-license-music/article68339830.ece"
},
{
"author": "InvestorPlace",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434102081x945839080534312800/image_InvestorPlace.png",
"symbol": "NVDA",
"text": "Writers covering the AI stocks space agree on one thing: Nvidia’s dramatic rise is spawning a whole new wave of AI winners.",
"timestamp": "2024-06-27T12:02:02",
"title": "3 AI Stocks on the Edge of a Massive Surge - InvestorPlace",
"url": "https://investorplace.com/2024/06/3-ai-stocks-on-the-edge-of-a-massive-surge/"
},
{
"author": "The Times of India",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434201376x170199258053463900/image_The_Times_of_India.png",
"symbol": "AAPL",
"text": "MOBILES & TABLETS News: Apple iPhone 14 Plus is currently available at a discounted price on Flipkart.",
"timestamp": "2024-06-27T11:39:00",
"title": "Apple iPhone 14 Plus is now more affordable than iPhone 14: Here’s how to get the deal - The Times of India",
"url": "https://timesofindia.indiatimes.com/technology/mobiles-tabs/apple-iphone-14-plus-is-now-cheaper-than-iphone-14-heres-how-to-get-the-deal/articleshow/111315799.cms"
},
{
"author": "India Today",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434465340x727619029504291500/image_India_Today.png",
"symbol": "AAPL",
"text": "Now that Apple has stepped into this race, will its AI model be 100 percent accurate all the time? Apple CEO Tim Cook answered.",
"timestamp": "2024-06-27T11:35:06",
"title": "Tim Cook talks about Apple stopping AI hallucinations - India Today",
"url": "https://www.indiatoday.in/visualstories/technology/tim-cook-talks-about-apple-stopping-ai-hallucinations-147236-27-06-2024"
},
{
"author": "InvestorPlace",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434102081x945839080534312800/image_InvestorPlace.png",
"symbol": "MSFT",
"text": "Explore tech stocks for long-term growth driven by AI innovations and solid market fundamentals. Microsoft (MSFT): Microsoft continues to dominate with its...",
"timestamp": "2024-06-27T11:32:38.067000",
"title": "3 Tech Stocks That Could Make Your Grandchildren Rich",
"url": "https://investorplace.com/2024/06/3-tech-stocks-that-could-make-your-grandchildren-rich/"
},
{
"author": "The Register",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713435556087x727925374208709800/image_The_Register.png",
"symbol": "MSFT",
"text": "Tour of recovery options not supposed to be part of KB5039302",
"timestamp": "2024-06-27T11:32:00",
"title": "Microsoft yanks Windows 11 update after boot loop blunder - The Register",
"url": "https://www.theregister.com/2024/06/27/windows_11_faulty_update/"
},
{
"author": "PR Newswire",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713434138597x459253446079698400/image_PR_Newswire.png",
"symbol": "MSFT",
"text": "/PRNewswire/ -- The Digital Neighborhood, a community of interconnected European tech companies specializing in Microsoft AI and Cloud, was honored with four...",
"timestamp": "2024-06-27T11:32:00",
"title": "Microsoft Names The Digital Neighborhood as a Global Leader in AI with Four Prestigious Partner of the Year Awards - PR Newswire",
"url": "https://www.prnewswire.com/news-releases/microsoft-names-the-digital-neighborhood-as-a-global-leader-in-ai-with-four-prestigious-partner-of-the-year-awards-302184437.html"
},
{
"author": "The Washington Post",
"author_profile_image_url": "https://3d6d93f328c4e3c163900bbea3dce4d3.cdn.bubble.io/f1713435502182x206076131071017300/image_Washington_Times.png",
"symbol": "NVDA",
"text": "Nvidia grew from an obscure chip designer to one of the most valuable companies in the world thanks to the AI boom",
"timestamp": "2024-06-27T11:27:41",
"title": "See how Nvidia became one of the world's most valuable companies - The Washington Post",
"url": "https://www.washingtonpost.com/technology/2024/06/27/nvidia-most-valuable-company-stock-key-moments/"
}
]
},
"request_id": "YOUR_REQUEST_ID",
"result": "success"
}Invalid values were supplied for the API request.
Example:
For the request:
https://api.main.finalle.ai/feed?&limit=105The output will have 400 response status code with the following response:
{
"result": "fail",
"error": "Bad request: Bad argument 'limit' provided: 105. Must be an integer in range 1-100"",
"request_id": "YOUR_REQUEST_ID"
}The API key supplied for the API request is invalid.
Example:
For the request:
https://api.main.finalle.ai/feedWith the following header:
{
"X-API-Key": "SOME_INVALID_API_KEY"
}The output will have 401 response status code with the following response:
{
"result": "fail",
"error": "Unauthorized api key: SOME_INVALID_API_KEY",
"request_id": "YOUR_REQUEST_ID"
}Something went wrong on our server.
The output will have 500 response status code with the following response:
{
"result": "fail",
"error": "Internal Server Error",
"request_id": "YOUR_UNIQUE_REQUEST_ID"
}Last updated