Real-Time Stream

Endpoints

WSwss://stream.newsfilter.io

Deprecated. New clients use the real-time stream of version 2.

A WebSocket connection that receives new articles as soon as they are indexed. Each message is a JSON object with an articles array. The articles have the fields of 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?apiKey=YOUR_API_KEY');

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

Message example

{
  "articles": [
    {
      "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"
      ]
    }
  ]
}