TravelPulse Theme Park Wait Times

{
  "type": "json",
  "errors": {
    "400": {
      "example": {
        "error": "park parameter required"
      },
      "description": "Invalid or missing parameter(s) — required: park. Returned before the payment gate on paid requests, so a malformed call is never charged. JSON body: { error: <what is wrong and how to fix it> } plus usage hints."
    },
    "402": {
      "description": "Payment required — x402 v2 challenge; the accepts array lists scheme, network, and amount. Retry the same request with a PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header. Verification is free."
    },
    "500": {
      "example": {
        "error": "upstream_failed"
      },
      "description": "Unexpected server error. If a payment settled without a usable result, contact info@theaslangroupllc.com with the settlement tx hash for a re-run or credit."
    }
  },
  "example": {
    "meta": {
      "park": "magic-kingdom",
      "action": "crowds",
      "park_found": true
    },
    "park": "Magic Kingdom",
    "narrative": "This is one of the busiest dates of the year at Magic Kingdom...",
    "comparison": {
      "worst_days_nearby": [
        "July 4 (10/10)",
        "July 5 (9/10)"
      ],
      "better_alternative_dates": [
        {
          "day": "Tuesday",
          "date": "2026-07-07",
          "reason": "Post-holiday weekday — significantly lower crowds",
          "crowd_level": 4
        }
      ]
    },
    "query_date": "2026-07-04",
    "agent_action": "Reschedule if flexible — consider July 7 for a dramatically better experience",
    "date_context": {
      "holiday": "Independence Day",
      "day_of_week": "Saturday",
      "school_status": "Summer break — all US schools out",
      "special_events": [
        "July 4th fireworks — extended hours until midnight"
      ]
    },
    "crowd_prediction": {
      "label": "Very Busy",
      "level": 9,
      "description": "Independence Day holiday weekend with extended hours draws peak attendance.",
      "expected_avg_wait_minutes": 65
    },
    "packing_recommendations": {
      "amazon_url": "https://www.amazon.com/s?k=theme+park+essentials+bag+disney&tag=pulsenetwork7-20",
      "must_bring": [
        "Portable phone charger",
        "Refillable water bottle",
        "Comfortable shoes"
      ]
    },
    "strategy_for_chosen_date": {
      "arrive_by": "07:30 — rope drop is critical on this date",
      "first_three_rides": [
        "Tron Lightcycle Run",
        "Seven Dwarfs Mine Train"
      ],
      "lightning_lane_priority": [
        "Seven Dwarfs Mine Train"
      ]
    }
  }
}