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.
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 editorialAdditionally, two RSS feeds in XML format are available: