Atom Tickets APIatomtickets.com ↗
Access Atom Tickets data via API: search movies and theaters, retrieve showtimes, ticket prices, cast, and ratings across 7 endpoints.
What is the Atom Tickets API?
The Atom Tickets API gives developers structured access to movie and theater data across 7 endpoints, covering everything from current and upcoming films to per-showtime ticket pricing. The get_showtime_ticket_details endpoint returns ticket type names, prices, service fees, and full-price text for a specific showtime, while get_theater_details returns grouped showtimes by movie and format for any theater on the platform.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/75560b1b-f96c-45c9-a560-e73446190e80/get_movies_in_theaters' \ -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 atomtickets-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: Atom Tickets SDK — browse movies, find theaters, check showtimes and pricing."""
from parse_apis.atom_tickets_api import AtomTickets, ResourceNotFound
client = AtomTickets()
# List movies currently in theaters
for movie in client.movies.list_in_theaters(limit=3):
print(movie.title, movie.movie_id)
# Drill into the first movie's full details (cast, duration, rating)
movie = client.movies.list_in_theaters(limit=1).first()
if movie:
detail = movie.details()
print(detail.name, detail.contentRating, detail.duration)
# Find theaters near a ZIP code
theater = client.theaters.list_near(location="90001", limit=1).first()
if theater:
info = theater.details()
print(info.theater_name, info.address)
# Walk showtimes for the first movie at this theater
if info.movies:
tm = info.movies[0]
print(tm.title, tm.movie_id)
for fmt in tm.formats[:1]:
for st in fmt.showtimes[:2]:
print(st.time, st.showtime_id)
# Search for a movie by keyword
results = client.searches.search(query="batman")
for m in results.movies[:3]:
print(m.title, m.slug)
# Get ticket pricing for a specific showtime (constructible from ID)
try:
tickets = client.showtime(showtime_id="630380151").ticket_details()
print(tickets.movie_name, tickets.theater_name)
for price in tickets.prices:
print(price.name, price.full_price_text)
except ResourceNotFound as exc:
print(f"Showtime expired or not found: {exc}")
print("exercised: movies.list_in_theaters / movie.details / theaters.list_near / theater.details / searches.search / showtime.ticket_details")
Get a list of movies currently playing in theaters. Returns all movies shown on the Atom Tickets homepage with their titles, IDs, slugs, and URLs. No input required.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of movie objects with title, movie_id, slug, and url"
},
"sample": {
"data": {
"items": [
{
"url": "https://www.atomtickets.com/movies/disclosure-day/361251",
"slug": "disclosure-day",
"title": "Disclosure Day",
"movie_id": "361251"
},
{
"url": "https://www.atomtickets.com/movies/scary-movie/360603",
"slug": "scary-movie",
"title": "Scary Movie",
"movie_id": "360603"
}
]
},
"status": "success"
}
}About the Atom Tickets API
Movies and Theater Discovery
Two listing endpoints cover the film slate: get_movies_in_theaters returns all movies currently playing with their title, movie_id, slug, and url, and get_movies_coming_soon returns the same fields for upcoming releases, which may include special events. Both outputs feed directly into get_movie_details, which requires both slug and movie_id and returns the full record — description, duration (ISO 8601 format), director objects, author (writer) objects, user review arrays, and image URLs. The search_movies_and_theaters endpoint accepts a free-text query and returns matched movies and theaters arrays, each with their respective IDs and slugs.
Theater and Showtime Data
get_theaters_near_location accepts an optional ZIP code or city name as location and returns a list of nearby theaters with name, theater_id, slug, and url. Omitting the parameter returns a default set. From there, get_theater_details takes a theater_id and slug and returns movies grouped by format, each containing nested showtime entries, plus address and theater_name. Note that address may be empty for some theaters.
Ticket Pricing
get_showtime_ticket_details is the most granular endpoint. It accepts a showtime_id obtained from get_theater_details results and returns a prices array where each entry includes ticket name, price, service_fee, and full_price_text. The metadata object provides productionName, venueName, localShowDate, localShowTime, and showtimeEpochSeconds. Showtimes expire after their scheduled time, so stale showtime_id values will not return valid results.
The Atom Tickets API is a managed, monitored endpoint for atomtickets.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when atomtickets.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 atomtickets.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 showtime aggregator that compares ticket prices and service fees across nearby theaters for a given movie.
- Track fluctuations in Atom Tickets service fees over time using the
service_feefield fromget_showtime_ticket_details. - Display a movie detail page with cast, director, synopsis, and user reviews sourced from
get_movie_details. - Alert users when a new title appears in
get_movies_coming_soon, including special screenings and events. - Populate a theater finder using
get_theaters_near_locationwith ZIP code input, then drill into showtimes viaget_theater_details. - Index movie slugs and IDs from
search_movies_and_theatersto power autocomplete in a cinema app. - Pull ISO 8601 duration values from
get_movie_detailsto calculate travel-and-showtime scheduling for users.
| 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 Atom Tickets have an official public developer API?+
What does get_theater_details return, and how do showtimes relate to get_showtime_ticket_details?+
get_theater_details returns an array of movies, each with format groupings that contain individual showtime entries including showtime_id. You pass that showtime_id directly to get_showtime_ticket_details to retrieve ticket types, prices, service fees, and full showtime metadata for that specific screening.Does the API return seat maps or seat availability for a showtime?+
Is theater coverage available for all US locations, or are there gaps?+
get_theaters_near_location notes that coverage may be limited depending on location — it reflects theaters listed on Atom Tickets, which does not include every cinema chain nationwide. Some theater records also return an empty address field.Does the API expose critic scores or aggregated audience ratings for movies?+
get_movie_details returns a review array containing user review objects, but does not expose aggregated numeric ratings (such as a Rotten Tomatoes score or star average). If you need aggregated scores, you can fork this API on Parse and revise it to add an endpoint that targets a ratings aggregation source.