Setup Guide

Prerequisite:

• docker & docker compose
• jq
• make (optional)

Quick Setup:

docker compose --profile quick-setup build
# [+] Building 2/2
# ✔ fastapi    Built
# ✔ pgmoviedb  Built

docker compose --profile quick-setup up -d
# [+] Running 2/2
# ✔ Container postgres  Running 
# ✔ Container fastapi   Running

docker compose --profile quick-setup logs -f
# postgres  | title.basics.tsv imported!
# ...
# postgres  | 2025-05-16 19:26:23.344 UTC [1] LOG:  database system is ready to accept connections

Test API

curl localhost:8000/api/v1/movies | jq 

Visit http://localhost:8000/docs

📜 Disclaimer

This project uses IMDb data, which is freely available for personal and non-commercial use under IMDb’s Terms and Conditions.

⚠️ Important Notes:

• The IMDb dataset used in this project is obtained from IMDb’s official data dumps.
• IMDb owns all rights to the data. This project does not claim ownership of any IMDb data.
• The use of IMDb data in this project is solely for educational, research, or personal testing purposes.
• This project is not affiliated with or endorsed by IMDb in any way.
• Redistribution of IMDb data outside of IMDb’s licensed use is prohibited.

Usage Terms

By using this project, you acknowledge that:

• You are responsible for complying with IMDb’s terms of service.
• You must not use this project or its dataset for commercial purposes.
• You must not publicly redistribute IMDb data unless explicitly permitted by IMDb.