Energy Price News API

A project to create a public API that scrapes news sites for anything concerning the changes in energy prices.

This project's secondary aim is to help beginners learn how to contribute to open source projects and will be purposely kept as basic as possible.

Up to date version hosted at: RapidAPI Hub

Original Idea

This project was first thought up after watching this video by Ania Kubów, so many thanks to her for the inspiration. Be sure to check the channel out for more easy to follow tutorials!

Planned Features

• Links to articles
• End points for specific sources
• Thorough documentation
• An open and inviting issue-board to encourage discussion of future features

Language & Prerequisites

• Javascript primarily, therefore:
  • Node.js >v16
  • NPM
• A browser extension for viewing JSON is helpful like JSON Formatter

Warning The above mentioned Node version is important to be able to run this project properly as it makes use of some newer functions. Also, if you are not using linux, the JSON formatter browser extension is HIGHLY recommended.

Installation

• Fork this repo and then clone your fork to an empty local directory using SSH
• run:

npm install

• Now the basis of the project is here and can already be viewed by running:

npm run dev

• You may view the various endpoints by opening localhost:8000 in your browser and appending the desired route
  • e.g. localhost:8000/api/news

Contribution

The aim for this project it to be very easy to access, so please have a look through the contribution guide if you need an idea how or where to get started.

API documentation

Some rudimentary and development focused documentation on using the API can be found here, where you have listed the various endpoints available and how to make use of any additional features.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Soshun Esaki 💻	nulad 💻 🤔	takanome_dev 💻 ⚠️ 🤔 📖 🚇 🔧 🔬 👀 💬 🚧 📆 👀	AyushiN 💻	Yoshemith Castellanos Irribarren 💻 🤔 🚇 🖋 🎨	dbsaw 💻 🤔	Diego Cordoba 💻
Anu 📖	James Neff 💻	Jon Rutter 💻	Roberto 💻 🤔	Elmir Ismayilov 💻	Ramón Soria 💻	alesbe 💻 🐛
kvaithin 💻	apurva-hub 💻	cfkim 💻 🤔	Ghada 💻	Klesta Luli 💻	Jayavardhan 💻	Dalu46 💻
Ian 💻	Muiz Uvais 💻	scottjwilson 💻 🔌	k-puchala 💻	snehashish-ghosh98 💻	nomandhoni-cs 💻	Rohan Nair 💻
mrajen27 💻	Ketan Parmar 💻	Z Adil Khwaja 💻	MuminAhmadKhan 💻	Stefan Talbot 💻 🤔	Dev Parikh 💻	Will12 💻 💡
Rupali Haldiya 🐛	Ashwin Acharya 💻	Leon Lafayette 💻 🤔 🔬 ⚠️	Sayam Gandhak 💻 ⚠️	reny_pacheco 💻 ⚠️ 🤔	ChinmayKumbhare 💻	Chandan Kumar Mandal 💻
Hamza Nawab 💻 ⚠️	Andres Cespedes Morales 🚧	Madalin Ignisca 🚇 🧑‍🏫	Artur Bauer 💻	Aabhas Sao 💻	Susanna 💻	Ignacio Alvarado 💻
Łukasz Mielczarek 💻	Anubhav Adhikari 💻	Rahul Kumar 💻	Michael 📖	Sohaib Chebah 💻

This project follows the all-contributors specification. Contributions of any kind welcome!