Fandango APIfandango.com ↗

"""Walkthrough: Fandango SDK — search movies, browse theaters, check showtimes."""
from parse_apis.fandango_movie_showtimes_api import Fandango, MovieNotFound

client = Fandango()

# Search for movies by title keyword — limit caps total items fetched.
for movie in client.movies.search(query="Disclosure Day", limit=3):
    print(movie.name, movie.release_date, movie.link)

# Browse nearby theaters and their current movies/showtimes.
theater = client.theaters.list(zip_code="10001", limit=1).first()
if theater:
    print(theater.name, theater.city, theater.state)
    for movie in theater.movies:
        print(movie.title, [v.format_header for v in movie.variants])

# Get showtimes for a specific movie at nearby theaters.
for ts in client.theatershowtimes.list(movie_id="244050", zip_code="10001", limit=3):
    print(ts.name)
    for variant in ts.variants:
        print(variant.format_header, [s.time for s in variant.showtimes])

# Check movie calendar — which dates have showtimes available.
for day in client.calendardays.list(movie_slug="disclosure-day-2026-244050", zip_code="10001", limit=5):
    print(day.date, day.day_name_short, day.has_showtime)

# Typed error handling around a potentially failing call.
try:
    results = client.theatershowtimes.list_formats(movie_id="244050", zip_code="10001", limit=3)
    for ts in results:
        print(ts.name, [v.format_header for v in ts.variants])
except MovieNotFound as exc:
    print(f"Movie not found: {exc.movie_id}")

print("exercised: movies.search / theaters.list / theatershowtimes.list / calendardays.list / theatershowtimes.list_formats")