ThemeParks.wiki API

https://www.themeparks.wiki/api
Admin
The ThemeParks.wiki API offers free access to real-time and static theme park data, using an...
Tokens:2,743
Snippets:33
Trust Score:6.9
Update:1 month ago
Show doc for...
Tokens:
Raw
### GET /destinations

Source: https://www.themeparks.wiki/api

Retrieves a list of all top-level destination entities.

```APIDOC
## GET /destinations

### Description
Returns a list of all top-level destination entities available in the system.

### Method
GET

### Endpoint
/destinations
```

--------------------------------

### GET /entity/{id}/live

Source: https://www.themeparks.wiki/api/http

Retrieves live data for a specific entity.

```APIDOC
## GET /entity/{id}/live

### Description
Get entity live data.

### Method
GET

### Endpoint
https://api.themeparks.wiki/v1/entity/{id}/live

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the entity.
```

--------------------------------

### GET /entity/{entity_id}/live

Source: https://www.themeparks.wiki/api

Retrieves live data for an entity and its children.

```APIDOC
## GET /entity/{entity_id}/live

### Description
Provides real-time data such as wait times, operating hours, and show times for the specified entity and its children.

### Method
GET

### Endpoint
/entity/{entity_id}/live

### Parameters
#### Path Parameters
- **entity_id** (string) - Required - The unique identifier of the entity.
```

--------------------------------

### GET /destinations

Source: https://www.themeparks.wiki/api/http

Retrieves a list of all available theme park destinations.

```APIDOC
## GET /destinations

### Description
Get all destinations.

### Method
GET

### Endpoint
https://api.themeparks.wiki/v1/destinations

### Response
#### Success Response (200)
- **destinations** (array) - List of destination objects.
```

--------------------------------

### GET /entity/{id}

Source: https://www.themeparks.wiki/api/http

Retrieves data for a specific entity by its unique identifier.

```APIDOC
## GET /entity/{id}

### Description
Get entity data.

### Method
GET

### Endpoint
https://api.themeparks.wiki/v1/entity/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the entity.
```

--------------------------------

### Retrieve Destinations JSON Response

Source: https://www.themeparks.wiki/api/http

Example structure of the JSON response returned by the /destinations endpoint.

```json
{
  "destinations": [
    {
      "id": "e9dd929c-7ef4-4ddf-9a78-5ded2d968aa8",
      "name": "Universal Orlando Resort",
      "slug": "universalorlando",
      "parks": [
        {
          "id": "2d305b4c-42b3-4745-8ce4-afb02f7ce0bc",
          "name": "Universal's Islands of Adventure"
        },
        {
          "id": "c4fe5a86-8553-445d-b456-b9a0131e0c79",
          "name": "Universal Studios Florida"
        }
      ]
    }
  ]
}
```

--------------------------------

### GET /entity/{id}/schedule

Source: https://www.themeparks.wiki/api/http

Retrieves calendar data for a specific entity.

```APIDOC
## GET /entity/{id}/schedule

### Description
Get entity calendar data.

### Method
GET

### Endpoint
https://api.themeparks.wiki/v1/entity/{id}/schedule

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the entity.
```

--------------------------------

### GET /entity/{id}/schedule/{year}/{month}

Source: https://www.themeparks.wiki/api/http

Retrieves calendar data for a specific entity for a given year and month.

```APIDOC
## GET /entity/{id}/schedule/{year}/{month}

### Description
Get entity calendar data for a specific year & month.

### Method
GET

### Endpoint
https://api.themeparks.wiki/v1/entity/{id}/schedule/{year}/{month}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the entity.
- **year** (string) - Required - The year.
- **month** (string) - Required - The month.
```

--------------------------------

### GET /entity/{entity_id}/children

Source: https://www.themeparks.wiki/api

Retrieves all child entities for a given entity recursively.

```APIDOC
## GET /entity/{entity_id}/children

### Description
Retrieves the full hierarchy of child entities associated with the specified parent entity.

### Method
GET

### Endpoint
/entity/{entity_id}/children

### Parameters
#### Path Parameters
- **entity_id** (string) - Required - The unique identifier of the parent entity.
```

--------------------------------

### GET /entity/{id}/children

Source: https://www.themeparks.wiki/api/http

Retrieves the children entities associated with a specific entity.

```APIDOC
## GET /entity/{id}/children

### Description
Get entity children.

### Method
GET

### Endpoint
https://api.themeparks.wiki/v1/entity/{id}/children

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the parent entity.
```

--------------------------------

### Fetch Destinations in Python

Source: https://www.themeparks.wiki/api/http

Basic implementation using the requests library to retrieve destination data.

```python
import requests


# Get all destinations
response = requests.get('https://api.themeparks.wiki/v1/destinations')
data = response.json()
print(data)
```

--------------------------------

### Handle Rate Limits in JavaScript

Source: https://www.themeparks.wiki/api/http

Logic for checking the 429 status code and reading the Retry-After header.

```javascript
// Example of handling rate limits in JavaScript
fetch('https://api.themeparks.wiki/v1/destinations')
  .then(response => {
    // Check if rate limited
    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After');
      console.log(`Rate limited. Retry after ${retryAfter} seconds`);
      // Handle retry logic here
      return;
    }
    return response.json();
  })
  .then(data => {
    if (data) console.log(data);
  })
  .catch(error => {
    console.error('Error:', error);
  });
```

--------------------------------

### Fetch Destinations in JavaScript

Source: https://www.themeparks.wiki/api/http

Basic implementation using the Fetch API to retrieve destination data.

```javascript
// Get all destinations
fetch('https://api.themeparks.wiki/v1/destinations')
  .then(response => response.json())
  .then(data => {
    console.log(data);
  })
  .catch(error => {
    console.error('Error:', error);
  });
```

--------------------------------

### Standard Entity JSON Structure

Source: https://www.themeparks.wiki/api

The base JSON schema for all entities, featuring unique identifiers, hierarchy references, location data, and a metadata tags array.

```json

// Entity Structure
{
  // Basic properties present in all entities
  "id": "00000000-0000-0000-0000-000000000000",              // Unique identifier for this entity
  "name": "Magic Kingdom",     // Human-readable name
  "entityType": "PARK",        // Type: DESTINATION|PARK|ATTRACTION|SHOW|RESTAURANT|HOTEL
  
  // Hierarchy information
  "parentId": "00000000-0000-0000-0000-000000000000",           // ID of the parent entity (null for destinations)
  "destinationId": "00000000-0000-0000-0000-000000000000",      // ID of the top-level destination this entity belongs to (null for destinations)
  "parkId": "00000000-0000-0000-0000-000000000000",        // ID of the park this entity belongs to (null for parks, destinations, and entities not inside a park)
  
  // Geographic and time details
  "timezone": "America/New_York", // Timezone for this entity
  "location": {                // Physical location (may be null)
    "latitude": 28.4177,
    "longitude": -81.5812
  },
  
  // Metadata
  "tags": [                    // Array of tags providing additional information
    {
      "tag": "fastpass_plus",  // Tag identifier
      "tagName": "FastPass+",  // Human-readable tag name
      "id": "fp",              // Optional ID for the tag
      "value": true            // Tag value (can be string, number, boolean or object)
    },
    {
      "tag": "opening_date",
      "tagName": "Opening Date",
      "value": "1971-10-01"    // YYYY-MM-DD date format
    }
  ]
}
```
Tokens:
Raw