financial-news-api

Stock Market & Financial News API

Access stock market and financial news of all publicly traded companies listed on US stock exchanges.

• More than 50 million articles accessible
• All major newswires included
• Real-time news stream API and historical news search API

Get your free API key: https://newsfilter.io/api-plans

Installation

npm install financial-news-api

Search API

The Search API allows you to access and search the news database with over 50 million articles. Newly published articles are added in real-time to the database.

const { SearchApi } = require('financial-news-api');

const searchApi = SearchApi('YOUR_API_KEY');

const query = {
  queryString: 'symbols:NFLX AND publishedAt:[2020-02-01 TO 2020-05-20]',
  from: 0,
  size: 10,
};

searchApi.getNews(query).then((articles) => console.log(articles));

Example Response

{
  "articles": [
    {
      "title": "FAANG emerges as the latest group to lead the market, Jim Cramer says",
      "description": "\"This market's been going through leadership groups like there's no tomorrow,\" the \"Mad Money\" host said.",
      "publishedAt": "2020-05-20T22:32:22+0000",
      "sourceUrl": "https://www.cnbc.com/2020/05/20/faang-emerges-as-the-latest-group-to-lead-the-market-jim-cramer-says.html",
      "source": {
        "name": "CNBC",
        "id": "cnbc"
      },
      "symbols": [
        "FB",
        "AAPL",
        "AMZN",
        "NFLX",
        "GOOGL",
        "TGT",
        "WMT",
        "HD",
        "LOW"
      ],
      "sectors": ["Technology", "Consumer Cyclical", "Consumer Defensive"],
      "industries": [
        "Internet Content & Information",
        "Consumer Electronics",
        "Specialty Retail",
        "Media - Diversified",
        "Discount Stores",
        "Home Improvement Stores"
      ],
      "imageUrl": "https://image.cnbcfm.com/api/v1/image/103267851-IMG_0161.jpg?v=1545882603",
      "id": "01a030ca440ba8732461703e9a906eb7"
    },
    {
      "title": "S&P 500 Clawing Toward 3,000 Milestone Finds Road Getting Harder",
      "description": "A rally this week has pushed the S&P 500 Index to 2,972. The 28-point road to 3,000 could be a slog.",
      "publishedAt": "2020-05-20T20:18:32.731Z",
      "sourceUrl": "https://www.bloomberg.com/news/articles/2020-05-20/s-p-500-s-next-even-number-milestone-will-be-tough-to-reach",
      "source": {
        "name": "Bloomberg",
        "id": "bloomberg"
      },
      "symbols": ["FB", "AMZN", "NFLX"],
      "sectors": ["Technology", "Consumer Cyclical"],
      "industries": [
        "Internet Content & Information",
        "Specialty Retail",
        "Media - Diversified"
      ],
      "imageUrl": "https://assets.bwbx.io/images/users/iqjWHBFdfxIU/iiT4fbpCD7v8/v2/-1x-1.png",
      "id": "a63b37b42f4c2a856535a3b7e8bb3190"
    }
  ]
}

Stream API

Setting up a news streaming API to receive newly published articles in real-time can be done in less than 10 lines of code.

const { StreamApi } = require('financial-news-api');

const API_KEY = 'YOUR_API_KEY';

const streamApi = StreamApi(API_KEY);

streamApi.on('articles', (articles) => console.log(articles[0].title));
streamApi.on('error', (err) => console.log('Connection error ' + err));
streamApi.on('open', () => console.log('Connection open'));
streamApi.on('close', () => console.log('Connection closed'));

The StreamApi is a simple event emitter wrapped around a websocket client. The StreamApi emits four different events:

Event: 'articles'

• articles (array) - Array of newly published articles
  • id (string) - unique ID of the article
  • title (string) - title of the article
  • description (string) - short description of the article
  • sourceUrl (string) - URL to original article
  • imageUrl (string, optional) - URL of article thumbnail
  • publishedAt (string) - ISO 8601 formatted date of publication time, e.g. 2020-06-08T12:23:00-04:00
  • source (object) - the source of the article. See the list below for all supported sources.
    • id (string) - unique ID of news source, e.g. businesswire
    • name (string) - human readable name of news source, e.g. BusinessWire
  • symbols (array) - array of ticker symbols mentioned in the article, e.g. AAPL
  • industries (array) - industries of the tickers mentioned in the article.
  • sectors (array) - sectors of the tickers mentioned in the article.

Emitted when new articles arrive.

Event: 'open'

Emitted when the connection is established.

Event: 'close'

Emitted when the connection is established.

Event: 'error'

• error (string)

Emitted when an error occurs.

Topics

The news API supports a large range of topics, for example:

• Quarterly and annual earnings reports
• Insider trading reports filed with the SEC
• Merger & acquisition news
• IPOs and offerings
• Legal proceedings and federal investigations
• Changes to management

News Sources

News Provider	Source ID
Analyst Ratings	analystUpgrades
Bloomberg	bloomberg
Reuters	reuters
CNBC	cnbc
Wall Street Journal	wall-street-journal
Barrons	barrons
PR Newswire	prNewswire
Globe Newswire	globenewswire
BusinessWire	businesswire
AccessWire	accesswire
SeekingAlpha	seekingAlpha
Zacks Equity Research	zacks
Benzinga	benzinga
S&P Global	sandpGlobal
Earnings Call Transcripts	earningsCallTranscripts
US:
ClinicalTrials.gov	clinicaltrials
Gov. Contract Awards (SAM.gov)	usSam
SEC Filings	sec-api
SEC Press Releases	secPressReleases
FCC Filings	fccFilings
CFTC Press Releases	cftc
Patent Database (USPTO)	uspto
Patent Trial & Appeal Board	usptoTrialAndAppeal
Department of Defense	usDod
FDA Drug Approvals	usFda (usFdaType = drugApproval)
FDA Press Releases	usFda (usFdaType = pressAnnouncement)