Skip to content

Latest commit

 

History

History
178 lines (148 loc) · 7.97 KB

README.md

File metadata and controls

178 lines (148 loc) · 7.97 KB
Raw

Stock Market News API

  • Get the latest stock market news from all relevant sources, covering all US listed companies
  • Query API to search the entire stock market news corpus
  • Real-time stream API to receive news as soon as they are published
  • New articles are indexed in real-time in less than 500 milliseconds after publication
  • Used by institutions, traders and investors in over 50 countries

See full API documentation at: https://developers.newsfilter.io/

News Query API Examples

You can get your API key from https://newsfilter.io/api-plans.

The below example fetches the 10 most recently published news articles from all sources covering Tesla and Apple.

const { queryApi } = require('stock-market-news-api');

queryApi.setApiKey('YOUR_API_KEY');

const query = {
  queryString: 'symbols:TSLA, AAPL', // most recent news from all sources covering TSLA and AAPL
  from: 0, // start with the first. used for pagination
  size: 10, // return 10 most recent articles, sorted by publishedAt
};

const news = await queryApi.getArticles(query);

You can narrow down the search by only fetching specific news sources, such as GlobeNewsWire, BusinessWire and PR Newswire.

const query = {
  queryString:
    'symbols:TSLA, AAPL AND source.id:prNewswire, globenewswire, businesswire',
  from: 0,
  size: 10,
};

const news = await queryApi.getArticles(query);

Response Example

{
  "total": { "value": 10000, "relation": "gte" },
  "from": 0,
  "size": 10,
  "sort": [{ "publishedAt": { "order": "desc" } }],
  "articles": [
    {
      "source": {
        "id": "cnbc",
        "name": "CNBC"
      },
      "symbols": ["GM", "TSLA", "VOW3-DE", "F"],
      "title": "GM ups spending on EVs and autonomous vehicles by 30% to $35 billion by 2025 on higher profits",
      "description": "GM, America's largest automaker, is racing to catch up to Tesla on EVs and become a leader in the space against other well-established automakers such as VW.",
      "url": "https://newsfilter.io/articles/gm-ups-spending-on-evs-and-autonomous-vehicles-by-30-to-35-billion-by-2025-on-higher-profits-34bd42f1c936c9a56c9bdf1914fadd5a",
      "imageUrl": "https://image.cnbcfm.com/api/v1/image/106424520-1583341306047gmevbarra01.jpg?v=1583353549",
      "publishedAt": "2021-06-16T13:00:23+0000",
      "id": "34bd42f1c936c9a56c9bdf1914fadd5a",
      "industries": ["Auto Manufacturers"],
      "sectors": ["Consumer Cyclical"]
    },
    {
      "source": {
        "id": "reuters",
        "name": "Reuters"
      },
      "symbols": ["TSLA"],
      "title": "Polestar to make electric SUV at U.S. Volvo plant, starting in 2022",
      "description": "Polestar, the premium electric vehicle maker owned by China's Geely and Volvo Cars, will build its Polestar 3 electric SUV at Volvo's U.S. plant in South Carolina starting in the second half of 2022, the brand's chief executive said.",
      "url": "https://newsfilter.io/articles/polestar-to-make-electric-suv-at-us-volvo-plant-starting-in-2022-27a0cb71fd98d2a011e9b188341172af",
      "imageUrl": "",
      "publishedAt": "2021-06-16T10:00:15Z",
      "id": "27a0cb71fd98d2a011e9b188341172af",
      "industries": ["Auto Manufacturers"],
      "sectors": ["Consumer Cyclical"]
    },
    {
      "source": {
        "id": "cnbc",
        "name": "CNBC"
      },
      "symbols": ["F", "GM", "TSLA"],
      "title": "Ford's luxury Lincoln brand aims for half of sales to be electric vehicles by 2026",
      "description": "Lincoln expects about half of its sales to be all-electric models by 2026, as it plans to offer new EVs across its portfolio of vehicles within the next decade.",
      "url": "https://newsfilter.io/articles/fords-luxury-lincoln-brand-aims-for-half-of-sales-to-be-electric-vehicles-by-2026-5f8bbcab3905d371cfe66b988f72b22c",
      "imageUrl": "https://image.cnbcfm.com/api/v1/image/106361970-1580317286365lincolnstar_electricblue.jpg?v=1623792027",
      "publishedAt": "2021-06-16T10:00:01+0000",
      "id": "5f8bbcab3905d371cfe66b988f72b22c",
      "industries": ["Auto Manufacturers"],
      "sectors": ["Consumer Cyclical"]
    },
    {
      "source": {
        "id": "benzinga",
        "name": "Benzinga"
      },
      "symbols": ["TSLA"],
      "title": "Elon Musk Says New HVAC Firmware Coming 'Soon' In Tesla EVs That Will Be 'Quieter'",
      "description": "Tesla Inc’s (NASDAQ: TSLA) CEO Elon Musk on Tuesday said cabin noise for its mid-size sedan Model 3 is set to get even \"quieter\" soon. What Happened: Musk tweeted in response to a video to say Tesla is working on new HVAC firmware - heating, ventilation and air conditioning -...",
      "url": "https://newsfilter.io/articles/elon-musk-says-new-hvac-firmware-coming-soon-in-tesla-evs-that-will-be-quieter-0b5cc8d5a92cc8f081d694e1c6ca7587",
      "imageUrl": "",
      "publishedAt": "2021-06-16T05:16:00-04:00",
      "id": "0b5cc8d5a92cc8f081d694e1c6ca7587",
      "industries": ["Auto Manufacturers"],
      "sectors": ["Consumer Cyclical"]
    }
  ]
}

News Stream API Examples

Our real-time stream API allows you to receive new articles as soon as they are published. The below example illustrates how to connect to the stream API.

const { streamApi } = require('stock-market-news-api');

streamApi.connect('YOUR_API_KEY');

streamApi.on('articles', (articles) => console.log(articles));

News Topics

We cover topics such as analyst ratings, earnings releases, press releases, M&A announcements, FDA drug approvals, clinical trial results, offerings, IPOs, SPACs, earnings call transcripts, patent approvals, SEC filings, government contract awards, insider trades, class action law suits, market research reports.

News Source Coverage

Supported news sources include:

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
Benzinga benzinga
S&P Global sandpGlobal
Earnings Call Transcripts earningsCallTranscripts
US:
ClinicalTrials.gov clinicaltrials
SAM.gov usSam
SEC Filings sec-api
SEC Press Releases secPressReleases
FCC Filings fccFilings
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)
Economic Indicators usEconomicIndicators

Please contact us at [email protected] if you like us to add more sources.

Companies & Exchanges

All companies listed on the following stock exchanges are supported:

  • NASDAQ
  • NYSE
  • AMEX/NYSE American

Contact

Website: https://newsfilter.io