AMC Theatres APIamctheatres.com ↗
Get AMC Theatres movie showtimes, formats (IMAX, Dolby, Laser), and theatre listings by market. Filter by date, theatre slug, and city.
What is the AMC Theatres API?
The AMC Theatres API provides 2 endpoints that return current movie showtimes and theatre location data directly from amctheatres.com. The get_showtimes endpoint delivers every movie playing at a specific AMC location on a given date, including format variants like IMAX, Dolby Cinema, and Laser at AMC, per-showtime availability status, ratings, posters, and runtime. The list_theatres endpoint maps market slugs to valid theatre slugs for use across the API.
curl -X GET 'https://api.parse.bot/scraper/52c31c90-81d2-412e-ab12-c18bfddf9da8/get_showtimes?date=2026-07-08&market=new-york-city&theatre=amc-glen-cove-6' \ -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 amctheatres-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.
"""AMC Theatres: discover theatres and browse showtimes by format."""
from parse_apis.amc_theatres_showtimes_api import AMC, TheatreNotFound
client = AMC()
# List theatres in a market, capped to 5
for theatre in client.market("new-york-city").theatres(limit=5):
print(theatre.name, theatre.city, theatre.state)
# Get showtimes for a specific theatre
movie = client.theatre("amc-empire-25").showtimes(limit=1).first()
if movie:
print(movie.title, movie.rating, movie.duration)
for group in movie.showtime_groups[:2]:
print(f" {group.format}: {[st.time for st in group.showtimes[:3]]}")
# Handle a non-existent theatre gracefully
try:
client.theatre("amc-nonexistent-99").showtimes(limit=1).first()
except TheatreNotFound as exc:
print(f"Theatre not found: {exc.theatre}")
print("exercised: market.theatres / theatre.showtimes / TheatreNotFound")
Get movie showtimes for a specific AMC theatre. Returns all movies currently playing with their showtimes grouped by format (IMAX, Dolby Cinema, Laser, etc.), including duration, rating, poster, amenities, and availability status.
| Param | Type | Description |
|---|---|---|
| date | string | Date in YYYY-MM-DD format to filter showtimes. When omitted, returns the current day's showtimes. |
| theatre | string | Theatre slug (e.g., 'amc-empire-25', 'amc-burbank-16'). Use list_theatres to discover valid slugs for a market. |
{
"type": "object",
"fields": {
"date": "string - Date queried (YYYY-MM-DD or 'today')",
"market": "string - Market slug",
"movies": "array - List of movies with showtime_groups containing format, amenities, and individual showtimes with time, availability, and date",
"theatre": "string - Full theatre name",
"movie_count": "integer - Number of movies with showtimes",
"theatre_slug": "string - Theatre slug",
"available_dates": "array - Dates with available showtimes, each with date (YYYY-MM-DD) and label fields"
},
"sample": {
"data": {
"date": "today",
"market": "new-york-city",
"movies": [
{
"slug": "star-wars-the-mandalorian-and-grogu-60322",
"genre": "Action",
"title": "Star Wars: The Mandalorian and Grogu",
"rating": "PG13",
"duration": "2 HR 12 MIN",
"poster_url": "https://amc-theatres-res.cloudinary.com/v1777914945/amc-cdn/content/general/w7xewp7excf6dnk9qcln.jpg",
"showtime_groups": [
{
"format": "IMAX with Laser at AMC",
"amenities": [
"IMAX at AMC",
"AMC Club Rockers",
"Reserved Seating"
],
"showtimes": [
{
"date": "June 10, 2026",
"time": "12:15",
"showtime_id": "U2hvd3RpbWU6MTQzNzkzMzY2",
"availability": "Past"
}
]
}
]
}
],
"theatre": "AMC Empire 25",
"movie_count": 28,
"theatre_slug": "amc-empire-25",
"available_dates": [
{
"date": "2026-06-10",
"label": "June 10, 2026"
}
]
},
"status": "success"
}
}About the AMC Theatres API
Showtimes by Theatre and Date
The get_showtimes endpoint accepts a theatre slug (e.g., amc-empire-25) and an optional date in YYYY-MM-DD format. When date is omitted, the response defaults to today's schedule. The movies array in the response groups each film's screenings by showtime_groups, where each group carries the presentation format (IMAX, Dolby Cinema, PLF Laser, etc.), amenity flags, and an array of individual showtimes with time, availability, and date fields. The response also includes available_dates — a list of upcoming dates that have scheduled showtimes — useful for building date-picker UIs.
Theatre Discovery by Market
Before calling get_showtimes, use list_theatres to resolve valid theatre slugs. Pass a market slug such as new-york-city or los-angeles and get back the full list of AMC locations in that area with each theatre's slug, name, city, and state. The market_name field returns a human-readable label for the queried market.
Response Shape Details
Each movie entry in the get_showtimes response includes duration, MPAA rating, poster URL, and format-level amenities alongside the timed screening slots. The top-level movie_count integer tells you at a glance how many titles are scheduled at the theatre on the queried date. The theatre and theatre_slug fields echo back the location so responses are self-identifying when batching across multiple theatres.
The AMC Theatres API is a managed, monitored endpoint for amctheatres.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amctheatres.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 amctheatres.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 showtimes aggregator that pulls AMC listings alongside other chains to compare screening times by zip code.
- Track IMAX and Dolby Cinema availability across multiple AMC markets for premium-format film releases.
- Power a mobile app that lets users browse what's playing at their nearest AMC location today without leaving your app.
- Aggregate
available_datesacross theatres to show users which days a specific title is scheduled. - Monitor
availabilitystatus fields on individual showtimes to alert users when seats open for high-demand screenings. - Use
list_theatresto populate a location selector dropdown tied to market slugs for a cinema planning tool. - Analyze format distribution (IMAX vs Laser vs standard) across markets on opening weekends for studio research.
| 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 AMC Theatres have an official developer API?+
What does get_showtimes return beyond just screening times?+
showtime_groups. Individual showtime slots carry a time, availability status, and date. The top-level available_dates array lists upcoming dates with scheduled showtimes for the queried theatre.Does the API cover AMC theatres outside the United States?+
list_theatres endpoint using domestic market slugs. International AMC or Odeon locations are not currently included. You can fork this API on Parse and revise it to add an endpoint targeting international theatre markets.Can I look up showtimes by movie title rather than by theatre?+
theatre slug to get_showtimes and retrieve all movies at that location. There is no endpoint that accepts a film title or ID and returns all theatres showing it. You can fork this API on Parse and revise it to add a movie-centric search endpoint.How far in advance does the available_dates field show showtimes?+
available_dates array reflects whatever advance scheduling AMC has published for the queried theatre, typically up to a week out for most titles, though limited engagements or new releases may show fewer future dates. The range is determined by what AMC has loaded into their schedule at query time.