Yava Gym API

Find the best time to go to the gym with the (unofficial) Yava API that lets you know the gym's busiest hours 💪

Why I Created This?

Due to Covid-19, Yava Fitness Center (the gym i go to) implemented an online platform YAVA360 where you make a booking in order to use the gym's facilities and also has a cap on how many people can book for each hour of the day.

So, i found myself wasting too much time visiting my gym's poorly designed website, searching for the best time to book and always checking for the capacity as i was trying to book when the gym had the least people.

What Does it Do?

This API uses Puppeteer, a headless chrome browser to scrape the YAVA360 webpage and then exposes an API endpoint which provides information on the gym's capacity per hour in a JSON format.

Getting Started

Heroku

If you do not want to install and run the API locally you can always hit the online instance running on Heroku at https://yava-gym-api.herokuapp.com/.

Installation

$ npm install
# To run with node
$ npm run start
# To run with nodemon
$ npm run dev

Docker Image

You can spin up a docker container with the image i've created if you are using docker.

$ docker pull kostaschikis/yava-gym-api:latest
$ docker run -p 3000:3000 kostaschikis/yava-gym-api

Usage

Request

⚠ You need a YAVA360 account in order to use this API

POST https://yava-gym-api.herokuapp.com/

💭 POST http://localhost:3000 if you are running locally

Headers

Key	Value
Content-Type	application/json

Body

Your YAVA360 account credentials

{
  "email": "yava360email@yava",
  "password": "yava360password",
  "gym": "codename"
}

❗ Find your gym's codename by doing a GET request on https://yava-gym-api.herokuapp.com/gyms

Response

A JSON array of objects where every object is a day of the week.

[
  {
    "date": "Thursday Oct 29th",
    "data": [
      {
        "hour": "07:00",
        "people": 15
      },
      {
        "hour": "08:00",
        "people": 15
      },
      {
        "hour": "09:00",
        "people": 18
      },
      {
        "hour": "10:00",
        "people": 20
      },
      {
        "hour": "11:00",
        "people": 13
      }
    ]
  },
  {
    "date": "Friday Oct 30th",
    "data": []
  }
]

❗ The scraper returns only the days where at least 1 booking is found, starting from the current date.

To-Do

• Insert gym name into POST request body
• Automatic user's gym detection (Maybe)

License & Copyright

@ Kostas Chikimtzis. Licensed under the MIT License.