A free and simple API to help you find something better to do
This project is an MEVN (MongoDB, Express.js, Vue.js, and Node.js) web app that has a goal of creating a simple way to find things to do. You do not need an API key to use this API, just query the endpoint to get data. All activities served by the API can be found here.
The full documentation can be found here, but listed below are a few of the endpoints.
Gets a random event
/api/activity/
Response:
{
"activity": "Learn Express.js",
"accessibility": 0.25,
"type": "education",
"participants": 1,
"price": 0.1,
"link": "https://expressjs.com/",
"key": "3943506"
}
Query for events by a certain type
/api/activity?type=:type
Response:
{
"activity": "Learn how to play a new sport",
"accessibility": 0.2,
"type": "sports",
"participants": 1,
"price": 0.1,
"key": "5808228"
}
To set up your own Bored API, clone the app, start your MongoDB instance, and run:
npm install
npm start
# Started on port 8080All help is welcome! A pull request or a new issue would be very appreciated. If you want to add more activities, I've created a UI on the website to make suggesting easy.
The Bored API has been used in many other applications and projects: