atomtickets.com APIatomtickets.com ↗
Access Atom Tickets data via API: search movies and theaters, retrieve showtimes, ticket prices, cast, and ratings across 7 endpoints.
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'
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 parameters required.
{
"type": "array",
"fields": {
"url": "full URL to movie page on atomtickets.com",
"slug": "URL-safe movie identifier slug",
"title": "movie title",
"movie_id": "numeric movie identifier"
},
"sample": {
"data": [
{
"url": "https://www.atomtickets.com/movies/the-devil-wears-prada-2/369153",
"slug": "the-devil-wears-prada-2",
"title": "The Devil Wears Prada 2",
"movie_id": "369153"
},
{
"url": "https://www.atomtickets.com/movies/michael/356098",
"slug": "michael",
"title": "Michael",
"movie_id": "356098"
}
],
"status": "success"
}
}About the atomtickets.com 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.
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.
- 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 | 250 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.