MovieTickets APImovietickets.com ↗
Access now-playing movies, theater locations, showtimes, and Rotten Tomatoes scores from MovieTickets.com via 7 structured API endpoints.
What is the MovieTickets API?
The MovieTickets.com API covers 7 endpoints that surface theater schedules, movie metadata, and ticketing data from the MovieTickets.com (Fandango) platform. Starting with get_now_playing_movies or get_coming_soon_movies, you can retrieve movie IDs and slugs needed to chain into showtime lookups, detailed cast and crew records, and Rotten Tomatoes critic and audience scores — all in structured JSON without building your own scraper or session management.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/e10a8363-fbd8-4be1-99a1-ac0dc298ae15/get_now_playing_movies' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace movietickets-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Fandango SDK — browse movies, check scores, find theaters and showtimes."""
from parse_apis.movietickets_fandango_api import Fandango, ZipCode, MovieNotFound
client = Fandango()
# List movies currently in theaters (capped to 5 items).
for movie in client.movies.list_now_playing(limit=5):
print(movie.title, movie.movie_id)
# Drill into the first now-playing movie for scores and showtimes.
movie = client.movies.list_now_playing(limit=1).first()
if movie:
# Get Rotten Tomatoes scores for this movie.
scores = movie.scores.get()
print(scores.critics_score, scores.audience_score, scores.certified_fresh)
# Check available showtime dates near NYC.
cal = movie.calendar.get(zip_code=ZipCode._10001)
print(cal.has_calendar, cal.showtime_dates)
# Get showtimes for the first available date.
if cal.showtime_dates:
result = movie.showtimes.get(date=cal.showtime_dates[0], zip_code=ZipCode._10001)
print(result.has_showtimes, result.date)
for theater in result.theaters[:3]:
print(theater.name, theater.distance)
# Find theaters near a zip code.
for theater in client.theaters.list_near(zip_code=ZipCode._10001, limit=3):
print(theater.name, theater.city_state_zip, theater.distance)
# Typed error handling: catch a missing movie.
try:
client.movies.get(movie_id="9999999")
except MovieNotFound as exc:
print(f"Movie not found: {exc.movie_id}")
print("exercised: movies.list_now_playing / scores.get / calendar.get / showtimes.get / theaters.list_near / movies.get")Retrieves all movies currently showing in theaters. Returns an array of movie summaries including IDs, slugs, titles, poster URLs, and Rotten Tomatoes scores. Use the returned movie_id and slug to call get_movie_details, get_movie_scores, or get_movie_calendar.
No input parameters required.
{
"type": "object",
"fields": {
"movies": "array of movie summary objects with movie_id, slug, title, poster_url, rt_score, audience_score, and url"
},
"sample": {
"data": {
"movies": [
{
"url": "https://www.fandango.com/scary-movie-2026-245093/movie-overview",
"slug": "scary-movie-2026",
"title": "Scary Movie (2026)",
"movie_id": "245093",
"rt_score": null,
"poster_url": "https://images.fandango.com/ImageRenderer/200/0/redesign/static/img/default_poster--dark-mode.png/0/images/MasterRepository/fandango/245093/SCRY_THEATRE_OnLine_Teaser_One_Sheet_2025x3000_04.30.26_NO_TECH.jpg",
"audience_score": null
}
]
},
"status": "success"
}
}About the MovieTickets API
Movie Discovery and Metadata
get_now_playing_movies and get_coming_soon_movies each return an array of movie objects with fields including movie_id, slug, title, poster_url, rt_score, and audience_score. These IDs and slugs serve as the input keys for every other endpoint. get_movie_details accepts a movie_id and returns a movieInfo object with genres, runtime, rating, synopsis, cast, crew, directors, releaseDate, and trailer data, plus an images array with URIs at multiple sizes. get_movie_scores returns a focused data object with criticsScore, audienceScore, criticsRating, audienceRating, certifiedFresh status, and a direct rottenTomatoesUrl.
Theater and Showtime Lookup
All theater and showtime queries are anchored to a 5-digit US zip_code. get_theaters_near_location returns a theaters array where each entry includes id, name, address, cityStateZip, distance, and a hasConcessions flag, plus a top-level concessionsEnabled boolean. For showtimes, the workflow is two-step: call get_movie_calendar with a slug, movie_id, and zip_code to get a movieCalendar object containing a showtimeDates array of YYYY-MM-DD strings, then pass one of those dates to get_movie_showtimes.
Showtime Detail Structure
get_movie_showtimes returns a theaterShowtimes object with a theaters array. Each theater entry carries id, name, address, distance, and a variants array that breaks showtimes into format and amenity groups — so IMAX, Dolby, 3D, and standard screenings appear as distinct entries. Individual showtime slots include ticketing URLs, enabling direct deep-linking to the booking flow on MovieTickets.com.
Coverage Notes
The API covers US theaters only; all location queries require a valid US zip_code. Movie IDs are specific to the MovieTickets.com catalog and are not interchangeable with IDs from other ticketing platforms. Cast and crew fields in get_movie_details return ID references rather than full biographical records.
The MovieTickets API is a managed, monitored endpoint for movietickets.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when movietickets.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official movietickets.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a local showtime finder that maps
get_theaters_near_locationresults againstget_movie_showtimesfor a given zip code and date - Aggregate Rotten Tomatoes critic and audience scores from
get_movie_scoresinto a movie recommendation feed - Populate a movie detail page with poster, synopsis, runtime, genres, and trailer data from
get_movie_details - Create calendar-aware notifications by polling
get_movie_calendarfor new showtime dates as they become available - Compare now-playing vs. coming-soon title lists to track when a film transitions from upcoming to actively scheduled
- Deep-link users directly to ticket purchase pages using showtime ticketing URLs returned by
get_movie_showtimes - Filter theater listings by concession availability using the
hasConcessionsfield fromget_theaters_near_location
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does MovieTickets.com have an official public developer API?+
What does get_movie_showtimes actually return, and how granular is the format breakdown?+
theaterShowtimes object containing a theaters array. Each theater includes a variants array that separates showtimes by format and amenity group — so IMAX, Dolby, 3D, and standard screenings appear as distinct entries, each with individual showtime slots and ticketing URLs.Does the API cover theaters outside the United States?+
get_theaters_near_location, get_movie_calendar, and get_movie_showtimes — require a 5-digit US zip code. International theater coverage is not available. You can fork this API on Parse and revise it to add a location query format that targets international markets if the underlying data becomes accessible.Can I retrieve full cast and crew biographical details through get_movie_details?+
cast and crew fields in get_movie_details return ID references, not full biographical records. Names, filmographies, and profile images for individual cast or crew members are not currently returned. You can fork the API on Parse and revise it to add a dedicated person-detail endpoint that resolves those IDs into full records.How do I get showtimes for a specific movie — is there a direct single-call path?+
get_movie_calendar with the movie's slug, movie_id, and a zip_code to get available showtimeDates. Then call get_movie_showtimes with a date from that array, the same movie_id, and zip_code. The calendar step is necessary because not every date has showings in every location.