MCU Countdown

How to Use This API

1. Get All Movies

https://mcu-countdown-api.vercel.app/api/movies

Returns all MCU movies with title, release date, phase, order, rating, and poster URL.

2. Get All TV Shows

https://mcu-countdown-api.vercel.app/api/shows

Returns all Disney+ MCU series with episode counts and release schedules.

3. Get Upcoming Releases

https://mcu-countdown-api.vercel.app/api/upcoming

Returns only unreleased/upcoming movies and shows sorted by release date.

4. Combined Timeline

https://mcu-countdown-api.vercel.app/api/all

Returns all MCU media (movies + shows) in chronological release order.

5. Response Format

{
  "id": "iron-man",
  "title": "Iron Man",
  "releaseDate": "2008-05-02",
  "phase": 1,
  "chronologicalOrder": 3,
  "director": "Jon Favreau",
  "runtime": 126,
  "posterUrl": "https://.../iron-man.jpg",
  "overview": "Tony Stark builds a high-tech suit...",
  "rating": "PG-13",
  "imdbRating": 7.9
}

6. JavaScript — Build a Watch Order

fetch('https://mcu-countdown-api.vercel.app/api/movies')
  .then(r => r.json())
  .then(movies => {
    movies.sort((a, b) => new Date(a.releaseDate) - new Date(b.releaseDate));
    movies.forEach((m, i) => {
      console.log(`${i + 1}. ${m.title} — ${m.releaseDate} (Phase ${m.phase})`);
    });
  });

7. Python — Filter by Phase

import requests

resp = requests.get('https://mcu-countdown-api.vercel.app/api/movies')
movies = resp.json()

# Show Phase 3 movies sorted by release
phase3 = [m for m in movies if m['phase'] == 3]
phase3.sort(key=lambda m: m['releaseDate'])

print("Phase 3 Movies:")
for m in phase3:
    print(f"  {m['title']} ({m['releaseDate']}) — {m['runtime']}min")

8. Python — Build Complete Timeline

import requests

movies = requests.get(
    'https://mcu-countdown-api.vercel.app/api/movies'
).json()
shows = requests.get(
    'https://mcu-countdown-api.vercel.app/api/shows'
).json()

# Combine and sort
timeline = movies + [{'title': s['title'], 'releaseDate': s['releaseDate'],
                      'type': 'TV Series'} for s in shows]
timeline.sort(key=lambda m: m['releaseDate'])

for item in timeline:
    item_type = item.get('type', 'Movie')
    print(f"  {item['title']} ({item['releaseDate']}) — {item_type}")