https://github.com/matt0550/eurostreamingapi-scraping

An unofficial REST API for Eurostreaming website, with a WebApp to search for movies and series. Using FastAPI and BeautifulSoup.
https://github.com/matt0550/eurostreamingapi-scraping

fastapi python rest-api scraping streaming

Last synced: about 1 year ago
JSON representation

An unofficial REST API for Eurostreaming website, with a WebApp to search for movies and series. Using FastAPI and BeautifulSoup.

Host: GitHub
URL: https://github.com/matt0550/eurostreamingapi-scraping
Owner: Matt0550
License: gpl-3.0
Created: 2024-08-21T18:21:58.000Z (almost 2 years ago)
Default Branch: main
Last Pushed: 2025-01-20T22:52:17.000Z (over 1 year ago)
Last Synced: 2025-02-12T06:02:09.228Z (over 1 year ago)
Topics: fastapi, python, rest-api, scraping, streaming
Language: Python
Homepage:
Size: 66.4 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

          [![Forks][forks-shield]][forks-url]

[![Stargazers][stars-shield]][stars-url]

[![Issues][issues-shield]][issues-url]

[![MIT License][license-shield]][license-url]

[![Discord][discord-shield]][discord-url]

[![Docker Pulls][docker-shield]][docker-url]






  

    

  

  
Eurostreaming Unofficial REST API & WebApp


  


    An unofficial REST API for Eurostreaming website, with a WebApp to search for movies and series. Using FastAPI and BeautifulSoup.

    


    


    Report Bug

    ·

    Request Feature

  



All the data is scraped from the Eurostreaming website. This project is for educational purposes only. I do not condone piracy in any way. Please use this project responsibly. 

Copyright and all rights belong to the respective owners.

# EurostreamingAPI-scraping

An unofficial REST API for Eurostreaming website, with a WebApp to search for movies and series. Using FastAPI and BeautifulSoup.

## Features

- Get all series per page

- Search for series

- Get the list of seasons and episodes of a series and related links to watch them

## API Endpoints

- `/shows/{page}`: Get all series per page. Page is an integer and is required.

- `/search?q={query}&page={page}`: Search for series. Query is a string and is required. Page is an integer and is optional.

- `/show?path={show_path}&alsoEpisodes={alsoEpisodes}`: Get the list of seasons and episodes of a series and related links to watch them. Show_path is a string and is required. AlsoEpisodes is a boolean and is optional, default is true.

> [!TIP]

> The API is self-documented. You can access the Swagger UI at `/docs` and the ReDoc UI at `/redoc`.

## WebApp

A WebApp is now available as a Telegram Mini App. Check out the repository [here](https://github.com/Matt0550/Eurostreaming-telegramBot).

Demo video:

https://github.com/user-attachments/assets/38c202f8-6bcc-4983-8847-cf5aaf0d9d2a

## TO-DO

- [X] Add Dockerfile

- [X] Add Docker Compose

- [X] Add WebApp (Now available as a Telegram Mini App. Check it out [here](https://github.com/Matt0550/Eurostreaming-telegramBot))

- [ ] Add show categories

## Public instance of the API

Currently, I’m unable to provide a public instance of the API because web scraping is not permitted by the Eurostreaming website and is considered unethical. To avoid any potential issues or conflicts, I’ve decided not to make the bot publicly accessible. I apologize for any inconvenience this may cause and appreciate your understanding.

## Environment Variables (docker)

| Variable | Description | Default |

| :--- | :--- | :--- |

| `PUID` | User ID | `1000` |

| `PGID` | Group ID | `1000` |

## Installation - Using Docker Compose (recommended)

Clone the project

```yml

version: '3'

services:

  eurostreaming_scraping:

    image: matt0550/eurostreamingapi-scraping

    environment:

      - PUID=1000     # UID of the user inside the container, make sure it has access to the database file

      - PGID=1000     # GID of the user inside the container, make sure it has access to the database file

    ports:

      - 5000:5000

    restart: unless-stopped

```

Run the container with `docker-compose up -d`

## Installation - Using Docker Run

Pull the image

```bash

  docker run -d -p 5000:5000 -e PUID=1000 -e PGID=1000 matt0550/eurostreamingapi-scraping

```

## Installation - Self-Host or docker build

Clone the project

```bash

  git clone https://github.com/Matt0550/EurostreamingAPI-scraping

```

Go to the project directory

```bash

  cd EurostreamingAPI-scraping-master

```

OPTIONAL: use docker to build the image

If you don't want to use docker, you can just go ahead and skip this step.

Otherwise, change the `image` in `docker-compose.yml` with the image name you used.

Run the container with `docker-compose up -d`

```bash

  docker build -t eurostreamingAPI-scraping .

```

Install dependencies

```bash

  pip install -r requirements.txt

```

Start the REST API (after setting the environment variables)

```bash

  cd api

  fastapi run api.py

```

## Help - feedback

You can contact me on:

Discord: https://matt05.it/discord

Telegram: https://matt05.it/telegram

Mail: mail@matteosillitti.com

## License

[GNU GPLv3](https://choosealicense.com/licenses/gpl-3.0/)

## Support me

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/matt05)

[![buy-me-a-coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/Matt0550)

[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://paypal.me/sillittimatteo)

[contributors-shield]: https://img.shields.io/github/contributors/Matt0550/EurostreamingAPI-scraping.svg?style=for-the-badge

[contributors-url]: https://github.com/Matt0550/EurostreamingAPI-scraping/graphs/contributors

[forks-shield]: https://img.shields.io/github/forks/Matt0550/EurostreamingAPI-scraping.svg?style=for-the-badge

[forks-url]: https://github.com/Matt0550/EurostreamingAPI-scraping/network/members

[stars-shield]: https://img.shields.io/github/stars/Matt0550/EurostreamingAPI-scraping.svg?style=for-the-badge

[stars-url]: https://github.com/Matt0550/EurostreamingAPI-scraping/stargazers

[issues-shield]: https://img.shields.io/github/issues/Matt0550/EurostreamingAPI-scraping.svg?style=for-the-badge

[issues-url]: https://github.com/Matt0550/EurostreamingAPI-scraping/issues

[license-shield]: https://img.shields.io/github/license/Matt0550/EurostreamingAPI-scraping.svg?style=for-the-badge

[license-url]: https://github.com/Matt0550/EurostreamingAPI-scraping/blob/master/LICENSE

[discord-shield]: https://img.shields.io/discord/828990499507404820?style=for-the-badge

[discord-url]: https://matt05.it/discord

[docker-shield]: https://img.shields.io/docker/pulls/matt0550/eurostreamingapi-scraping?style=for-the-badge

[docker-url]: https://hub.docker.com/r/matt0550/eurostreamingapi-scraping

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/matt0550/eurostreamingapi-scraping

Awesome Lists containing this project

README

Eurostreaming Unofficial REST API & WebApp