Skip to content

A consumable-only REST API to retrieve data about the upcoming films and shows in the Marvel Cinematic Universe.

License

Notifications You must be signed in to change notification settings

seaneoo/umcu-api

Repository files navigation

Warning

I will no longer be hosting an instance of this API in the near future. If you would like to keep using it, please create your own server.

UpcomingMCU API

UpcomingMCU (UMCU) API is a free, consumable-only REST API to retrieve data about the productions within the Marvel Cinematic Universe (MCU).

GitHub Release Build Boot Jar Build Docker Image

Installation

Before starting, ensure you have Docker and Docker Compose installed.

  1. Obtain an "API Read Access Token" from TMDB. This token will be used in step 3.

  2. Create a folder for the project. The location does not matter (such as the home directory).

mkdir umcu
cd umcu
  1. Run the following commands to download the required files. Make sure default.conf.template is in the nginx directory.
wget https://raw.githubusercontent.com/seaneoo/umcu-api/refs/heads/main/docker/compose.yaml
wget https://raw.githubusercontent.com/seaneoo/umcu-api/refs/heads/main/docker/nginx/default.conf.template --directory-prefix=nginx/default.conf.template
  1. Set the following environment variables on your machine. It is recommended that MONGO_USERNAME and MONGO_PASSWORD are secure, random strings.
export MONGO_USERNAME=[change me]
export MONGO_PASSWORD=[change me]
export TMDB_API_KEY=[your api read access token]
export TMDB_LIST_ID=8289533
  1. Run the Docker container.
docker compose -f compose.yaml up -d

Data

This product uses the TMDB API but is not endorsed or certified by TMDB.

Check them out here: The Movie Database.

License

GNU GPLv3