Real-Time Stream

Endpoints

WSwss://stream.newsfilter.io

A WebSocket connection that receives every new article as soon as it is indexed. Each message is one article object in JSON, with the same fields as in Search.

The stream has no filters. Filter the articles in the client.
Only articles indexed while the client is connected are sent. An article can arrive more than once; remove duplicates by id.
The server sends a ping every 30 seconds and closes connections that do not answer. Messages from the client are ignored.

Client example

WS wss://stream.newsfilter.io

const socket = new WebSocket('wss://stream.newsfilter.io?token=YOUR_API_KEY');

socket.onmessage = (event) => {
  const article = JSON.parse(event.data);
  console.log(article.publishedAt, article.title);
};

Try it

Not connected.

Message example

{
  "id": "ee56421c7fa15419833d3f9ccb984e09",
  "title": "Meta Reports Third Quarter 2026 Results",
  "description": "/PRNewswire/ -- Meta Platforms, Inc. (Nasdaq: META) today reported financial results for the quarter ended September 30, 2026. \"We hit major milestones this...",
  "url": "https://newsfilter.io/articles/meta-reports-third-quarter-2026-results-ee56421c7fa15419833d3f9ccb984e09",
  "sourceUrl": "https://www.prnewswire.com/news-releases/meta-reports-third-quarter-2026-results-302915964.html",
  "publishedAt": "2026-10-21T16:01:00.000-04:00",
  "source": {
    "id": "prnewswire",
    "name": "PR Newswire"
  },
  "symbols": [
    "META"
  ],
  "industries": [
    "Internet Content & Information"
  ],
  "sectors": [
    "Communication Services"
  ]
}