Port Brain API · v1

The intelligence layer
for cruise port days.

PortTrip aggregates behavioral data from thousands of real cruise port days — what passengers actually do, what they spend, how close they cut it to the ship. Now available via API.

Request API access

Historical Intelligence

Plans generated, avg costs, near-miss rates, transport patterns across 50+ ports.

Live Conditions

Real-time crowd-sourced data from passengers on the ground — queue times, transport status, crowd levels.

Risk Scoring

Predictive missed-ship probability calibrated against actual historical outcomes.

Authentication

All API requests require an API key passed as the x-api-key header. API access is available to enterprise customers. Contact us to request access.

curl -H "x-api-key: pt_live_your_key_here" \
  https://porttrip.com/api/v1/port-intelligence/Rome

Endpoints

GET/api/v1/port-intelligence/{port_name}

Returns aggregate intelligence for a cruise port — historical plan data, behavioral patterns, live conditions, and risk profile.

// GET /api/v1/port-intelligence/Rome
{
  "port": "Rome",
  "date": "2026-06-22",
  "plans_generated_total": 1847,
  "avg_diy_cost_eur": 34,
  "avg_ship_excursion_cost_eur": 165,
  "avg_saving_eur": 131,
  "near_miss_rate_pct": 12,
  "patterns_analyzed": 847,
  "most_common_transport": "train",
  "top_attractions": ["Colosseum", "Vatican", "Trevi Fountain"],
  "avg_leave_by_buffer_minutes": 135,
  "risk_profile": "medium",
  "live_conditions": {
    "report_count": 6,
    "crowd_level": "busy",
    "transport_status": "normal",
    "attraction_queue_minutes": 45,
    "last_updated": "2026-06-22T12:14:00Z",
    "notes": ["Taxi strike near Termini — use the Metro"]
  },
  "api_version": "v1"
}
GET/api/v1/live-conditions/{port_name}

Returns today's crowd-sourced conditions for a port. Updated throughout the day as passengers report from the ground.

// GET /api/v1/live-conditions/Santorini
{
  "port": "Santorini",
  "date": "2026-06-22",
  "report_count": 4,
  "crowd_level": "crowded",
  "transport_status": "normal",
  "tender_queue": "long",
  "attraction_queue_minutes": 20,
  "last_updated": "2026-06-22T11:45:00Z",
  "notes": ["Cable car queue over 1 hour — take the donkeys or walk"],
  "api_version": "v1"
}
POST/api/v1/risk-score

Calculates missed-ship probability for a given itinerary configuration, calibrated against historical PortTrip patterns.

// POST /api/v1/risk-score
// Body:
{
  "port": "Rome",
  "all_aboard_time": "17:00",
  "stops": ["Colosseum", "Vatican", "Trevi Fountain"],
  "transport_mode": "train",
  "date": "2026-06-22"
}

// Response:
{
  "port": "Rome",
  "risk_score": 67,
  "risk_level": "high",
  "factors": ["train_dependency", "high_stop_count"],
  "recommended_leave_by": "14:45",
  "historical_near_miss_rate_pct": 23,
  "similar_plans_analyzed": 412,
  "recommendation": "Remove one stop or switch to a faster transport mode",
  "api_version": "v1"
}

Ports covered

Rome (Civitavecchia)BarcelonaSantoriniAthens (Piraeus)DubrovnikVeniceNaplesFlorence (Livorno)MykonosSplitKotorVallettaPalma de MallorcaLisbon

Coverage expanding continuously as plans are generated. Enterprise customers can request priority port coverage.

Ready to integrate?

API access is available to cruise lines, excursion companies, and travel platforms. Enterprise pricing from €2,000/month.

Contact us for API access

We use cookies

Essential cookies are always on. We only enable analytics, marketing, personalisation, and session replay if you allow them. You can change this any time. Policy version 1.0.0. Privacy policy