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.


Each page is versioned in Markdown using GitHub. For example, the history of the front page is available here.


API Tree

Exact website file tree is visible on Offstream webstie source code repository on GitHub. However, 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


Source code and data

Each of the repositories below is updated every 2 hours, with timestamps according to UTC.


RSS Feeds

Additionally, two RSS feeds in XML format are available: - News Feed at offstream.news/index_rss.xml - Opinions Feed at offstream.news/opinion_rss.xml


Bugs and Issues

The best place to report bugs and issues is via the GitHub Issues of the Public repository.