nemesisx1 / cine_book_scrapping_api

A simple api to scrap a popular theater in Africa to get movies and theaters data

[Non-Official] Cine Book Web API (scrapper)

This is a non-official scrapper to get movies and theaters data directly from a famous theater's website.

If you want to contribute check this file.

👀 Overview

The full docs is located here. I also use the basics folders structures provided by the following command line :

npx ts-express

And the code architecture is mainly inspired by the default Nest.js one.

The core scrapper is made up of this package:

• Cheerio who helps us parsing the html document.

🚀 Deployment

• With npm

  npm install
  npm run start

• With Docker

  sudo docker compose up
  

  or

  sudo docker compose up -d
  

Then go to localhost:3213 or (localhost:PORT with PORT defined in the .env file)

Elikem Medehou

cine_book_scrapping_api's Issues

Return a movie only once when getting movies for a theater

Hello All.
Actually, on a get request on /movies/{theatherSlug}/, a movie can be returned multiple times, depending on the number of sessions.
Instead of doing that, we can add a sessions list to the corresponding model, so that each movie is returned only once.

Proposal: Individual Services for Each Controller

Our services are all stored into one big file. 🙈 Instead of that, I'm thinking, why don't we have separate services for each model?

Filter Theater names by country and city

Hello, I suggest to filter the names of the theaters by country and by city, what do you think about it ?
You can assign me this issue if you agree.

Replacing the node-html-parser by Cheerio

I guess it will be more suitable to move from node-html-parser to Cheerio which more mainstream. Feel free to pick this issues and submit a pull request about that.

Currently there is only the theatersNames() function which is using Cheerio. Thank to @abstractHunter for his pull request about that.

Feat: adding more routes to the /escape-games

It would be really good to add routes to check if a given theater has escape games available and to get available games of a given theater.

All these routes should work under the /escape-games route and support both English and French