Note: This service uses publicly available APIs and logos. All team names, logos, and trademarks are property of their respective owners.

---

Game Thumbs

A sports matchup thumbnail and logo generation API supporting 100+ professional and NCAA leagues.

Support

This project is maintained in my spare time. If it's saved you some headaches, a tip is always appreciated.

Quick Start

Docker Compose (Recommended)

docker compose up -d

Docker Run

docker run -p 3000:3000 ghcr.io/sethwv/game-thumbs:latest

Examples:

GET http://localhost:3000/nba/lakers/celtics/thumb
GET http://localhost:3000/nfl/chiefs/49ers/logo?style=3
GET http://localhost:3000/ncaa/football/alabama/georgia/thumb

Features

🏀 Multi-Sport • 🎨 Dynamic Generation • 🖼️ Multiple Styles • 💾 Smart Caching • 🎯 Flexible Matching • 🔧 Customizable

Supports: NBA, WNBA, NFL, MLB, NHL, UFC, PFL, Bellator, Boxing, Tennis (ATP/WTA with singles & doubles), EPL, MLS, UEFA, International/Olympics, 21+ NCAA sports, and more

Documentation

📚 View Full Documentation

• Docker Setup - Configuration and environment variables
• API Reference - All endpoints with examples
• Supported Leagues - League codes and sports
• Customization - Custom leagues and team overrides
• Contributing - How to contribute improvements

Contributing

🐛 Report a Bug • 💡 Request a Feature

Contributions are welcome! See the Contributing Guide for details.

License

MIT

Attribution

This service uses publicly available ESPN APIs and logos. All team names, logos, and trademarks are property of their respective owners.