themeparks.com APIthemeparks.com ↗
Access real-time wait times, operating schedules, attractions, shows, and restaurants for theme parks worldwide via the ThemeParks.com API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/5664de12-7303-4847-b13b-3fa34d75df25/get_destinations' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns a list of all supported theme park destinations globally, including each destination's parks.
No input parameters required.
{
"type": "object",
"fields": {
"destinations": "array of destination objects, each containing id, name, slug, and parks array"
},
"sample": {
"data": {
"destinations": [
{
"id": "643e837e-b244-4663-8d3a-148c26ecba9c",
"name": "SeaWorld Parks and Resorts Orlando",
"slug": "seaworldorlandoresort",
"parks": [
{
"id": "27d64dee-d85e-48dc-ad6d-8077445cd946",
"name": "SeaWorld Orlando"
}
],
"externalId": "seaworldorlandoresort"
}
]
},
"status": "success"
}
}About the themeparks.com API
The ThemeParks.com API covers global theme park data across 11 endpoints, returning real-time queue wait times, operating schedules, attraction lists, dining options, and park map data. The get_entity_live_data endpoint delivers live queue status and forecasts for a park and all its children in a single call, while search_parks lets you filter parks worldwide by name or retrieve the full global list.
Entity Model and Navigation
Every item in the API — destinations, parks, attractions, shows, and restaurants — is identified by a UUID. get_destinations returns the top-level list of destinations with their nested parks, giving you the IDs needed for every other endpoint. get_entity accepts any UUID and returns core metadata: name, slug, entityType, timezone, location (with latitude and longitude), parentId, and destinationId. get_entity_children returns all direct children of a parent entity, each with their own id, entityType, and location.
Live Data and Wait Times
get_entity_live_data is the primary real-time endpoint. Given a park UUID, it returns a liveData array where each entry includes status, queue (with standby and Lightning Lane wait times), forecast, operatingHours, and lastUpdated. get_park_wait_times wraps the same data but pre-filters to ATTRACTION entity types, so you get only rides with queue information. The get_park_map endpoint adds a global perspective: it returns all parks with isOpen, openUntil, nextOpen, attractionCount, showCount, averageWaitTime, and a latestWaitTimes snapshot across all reporting attractions.
Schedules
Two schedule endpoints cover different time scopes. get_entity_schedule returns the full available calendar for an entity, and get_entity_schedule_by_month accepts year and month parameters (both optional, defaulting to the current period) to narrow results. Both return a schedule array with date, type, openingTime, closingTime, and an optional purchases array that includes Lightning Lane pass pricing where the park makes it available.
Filtered Park Endpoints
get_park_attractions and get_park_restaurants return typed subsets of a park's children — ATTRACTION and RESTAURANT entity types respectively — each with id, name, slug, parentId, and location. These are useful when you need only one category without filtering a full children response yourself. search_parks accepts an optional query string for case-insensitive name matching and returns each result with isOpen, openUntil, nextOpen, attractionCount, and showCount.
- Build a wait-time dashboard that polls
get_entity_live_datafor multiple Disney and Universal parks and displays current queue lengths. - Create a trip-planning tool that reads
get_entity_schedule_by_monthto show park opening and closing times for a chosen travel month. - Populate an app's park directory using
get_destinationsandsearch_parksto let users browse or search parks globally. - Display a dining guide for a specific park by calling
get_park_restaurantsto retrieve all restaurant names and coordinates. - Render an interactive park map by combining
get_park_maplocation data withaverageWaitTimeand per-park open status. - Alert users when a target attraction's
statuschanges to OPERATING by monitoringget_park_wait_timeson a schedule. - Show Lightning Lane pricing history by month by archiving the
purchasesarray from repeatedget_entity_schedule_by_monthcalls.
| 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 ThemeParks.com have an official developer API?+
What does `get_entity_live_data` return, and how is it different from `get_park_wait_times`?+
get_entity_live_data returns a liveData array covering all child entity types — attractions, shows, and restaurants — each with status, queue, forecast, operatingHours, and lastUpdated. get_park_wait_times filters that same live data to only ATTRACTION types and surfaces the result in a wait_times array, removing the need to filter manually.How fresh is the live wait-time data?+
liveData and wait_times arrays includes a lastUpdated timestamp. Freshness depends on how frequently each park operator publishes updates to ThemeParks.wiki; high-traffic parks like those in the Walt Disney World resort tend to update every few minutes, while smaller parks may update less often.Does the API return historical wait-time data for trend analysis?+
Are show schedules and performance times included?+
get_entity_children results and in get_entity_live_data with operatingHours fields, but detailed per-show performance times (individual show start times throughout the day) are not broken out as a separate field. You can fork this API on Parse and revise it to add a dedicated shows endpoint that structures per-performance timing.