English中文

Offstream
news

API

Offstream aims to be an Open Website. Therefore, access to this website and its API is free, open, unmonitored, unlimited, possible in different formats and licensed under a permissive CC BY-SA 3.0 license.

Offstream news content is based on Wikipedia Current Events Portal and the API is very simple: each HTML page is also available in Markdown, JSON or XML. It's enough to change .html in the URL into an appropriate extension: .md, .json or .xml. Therefore, to access latest news on the front page and read them using JSON, it's enough to query offstream.news/index.json. If encryption is necessary, all URLs are also available via HTTPS.

API Tree

The most important information is structured as follows:

  • /index.[html, xml, json, md] – the front page, list with news files from the last 3 days
  • /news – contains the information from Wikipedia Current Events Portal
  • /news/[yyyy] – 4-digit year
  • /news/[yyyy]/[mm] – 2-digit month with leading zero
  • /news/[yyyy]/[mm]/[dd] – 2-digit day without leading zero
  • /news/[yyyy]/[mm]/[dd]/index.[html, xml, json, md] – list with all available news files for this day
  • /news/[yyyy]/[mm]/[dd]/[title].[html, xml, json, md] – the content of a single news, source metadata, related items
  • /opinion – contains dedicated editorial content
  • /opinion/index.[html, xml, json, md] – list with all available opinion editorials
  • /opinion/[yyyy] – 4-digit year
  • /opinion/[yyyy]/[mm] – 2-digit month with leading zero
  • /opinion/[yyyy]/[mm]/[dd] – 2-digit day without leading zero
  • /opinion/[yyyy]/[mm]/[dd]/[title].[html, xml, json, md] – the content of a single editorial

RSS Feeds

Additionally, two RSS feeds in XML format are available: