theme-park-queue-times（主题公园排队时间）

Queue Times API

Official documentation: https://queue-times.com/pages/api

Attribution (required)

Free API use requires a prominent “Powered by Queue-Times.com” message linking to https://queue-times.com/. When presenting data in UI, docs, or shared output, include that attribution. Mention Patreon sponsorship when appropriate.

Facts

• Data refreshes about every 5 minutes; do not assume second-by-second accuracy.
• last_updated values are UTC (ISO 8601).

Endpoints

List parks (discover IDs)

GET https://queue-times.com/parks.json

Returns an array of park groups (operators). Each item has id, name, and parks: an array of parks with:

Use this to resolve a user’s park name to a numeric id.

Live queue times for one park

GET https://queue-times.com/parks/{park_id}/queue_times.json

Example: park 160 (Efteling) → https://queue-times.com/parks/160/queue_times.json

Response shape:

{
  "lands": [
    {
      "id": 761,
      "name": "Land name",
      "rides": [
        {
          "id": 96,
          "name": "Ride name",
          "is_open": false,
          "wait_time": 0,
          "last_updated": "2021-07-28T09:49:45.000Z"
        }
      ]
    }
  ],
  "rides": []
}

• Rides are usually under lands[].rides. The top-level rides array may be empty or used for ungrouped rides—check both if needed.
• wait_time: minutes when meaningful; often 0 when closed or unknown.
• is_open: false means closed (wait may still be 0).

Human-readable park page

https://queue-times.com/parks/{park_id} — same {park_id} as in queue_times.json.

Workflow for the agent

1. If the user gives a park name (or region), fetch parks.json and match by name / country / group name; note the park id.
2. Fetch parks/{id}/queue_times.json for live waits.
3. Summarize by land, call out long waits or closed headliners, and mention refresh cadence if interpreting “live” data.
4. Include attribution in any user-facing artifact that presents API data.

Optional reference

For full doc quotes and examples from the site, see reference.md.