newsfilter
API Documentation v1

newsfilter.io API v1

Version 1 of the API, for clients built on the v1 format. New clients use version 2, which has the source IDs of version 2 and ascending sort. Article IDs are the same in both versions.

Base URL

https://api.newsfilter.io

Requests

  • Search accepts POST with a JSON body and Content-Type: application/json.
  • Every request needs an API key, sent as Authorization: YOUR_API_KEY or as ?token=YOUR_API_KEY. The stream takes it as ?apiKey=YOUR_API_KEY. Create a key in your profile. The keys of version 1 and version 2 are the same.
  • Timestamps are ISO 8601 strings with offset, for example 2026-10-21T10:40:02.000-04:00.