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&amp;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`)

Keywords

FAQs

What is financial-news-api?

Is financial-news-api well maintained?

Package last updated on 23 Dec 2022

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install