Epguides API

Free REST API for TV show data, episode lists, air dates, and plot summaries. Also includes an MCP server for AI assistant integration.

🔗 Links

Resource	URL
Public API	https://epguides.frecar.no
Swagger UI	https://epguides.frecar.no/docs
Full Documentation	https://epguides-api.readthedocs.io
MCP Endpoint	https://epguides.frecar.no/mcp

✨ Features

• 📺 TV Show Database — Metadata for thousands of TV series
• 🔍 Search — Find shows by title
• 📅 Seasons & Episodes — Browse by season or get full episode lists
• 📝 Plot Summaries — Episode and season descriptions via TVMaze
• 🖼️ Images — Show posters, season posters, episode stills
• ⏭️ Episode Tracking — Get next/latest episodes
• 🤖 AI Search — Natural language queries (LLM-powered)
• 🔌 MCP Server — JSON-RPC for AI assistants

🚀 Quick Start

No API key needed. Just start making requests:

# Search for shows
curl "https://epguides.frecar.no/shows/search?query=breaking+bad"

# Get show details (with poster)
curl "https://epguides.frecar.no/shows/BreakingBad"

# List seasons (with posters & summaries)
curl "https://epguides.frecar.no/shows/BreakingBad/seasons"

# Get episodes for a season (with episode stills)
curl "https://epguides.frecar.no/shows/BreakingBad/seasons/1/episodes"

# Get all episodes with filtering
curl "https://epguides.frecar.no/shows/BreakingBad/episodes?season=5"

# Get next episode
curl "https://epguides.frecar.no/shows/Severance/episodes/next"

📖 Documentation

Full documentation at epguides-api.readthedocs.io:

• Getting Started
• REST API Reference
• MCP Server
• Configuration
• Development

🛠️ Self-Hosting

Development

git clone https://github.com/frecar/epguides-api.git
cd epguides-api
make up

# API at http://localhost:3000 (with hot reload)

Production

make up-prod

# 12 workers, uvloop, 5GB Redis cache

See Development Guide for details.

📊 Data Sources

Source	Data
epguides.com	Show catalog, episode lists, air dates
TVMaze	Summaries, show/season posters, episode stills
IMDB	IMDB IDs

📄 License

MIT — see LICENSE