F9GWP Matrix — GoWild Flight Search

GET/api/search

Search for multi-leg GoWild routes using a time-expanded DFS algorithm.

Parameter	Type	Description
origin optional	string	Origin airport(s), comma-separated
dest optional	string	Destination airport(s), comma-separated
strictPath optional	string	Route path. Prefix ``=strict parenthesis, `#`/`~`=contains, can combine. Example `#PHX-(DEN)-MSY`
flightNumber optional	string	Filter by numeric segment flight number(s), e.g. `0343` or `0343,2297`
waypoints optional	string	`A&B`=AND (must include all), `A,B`=OR (include any)
t0 optional	date	Earliest departure: `YYYY-MM-DD`
t1 optional	date	Latest departure: `YYYY-MM-DD`
a0 optional	date	Earliest arrival: `YYYY-MM-DD`
a1 optional	date	Latest arrival: `YYYY-MM-DD`
maxDepth default: Auto	int	Max flight legs (request range: 1-20, auto defaults by query type)
minStops default:0	int	Minimum stops
maxBudget default:10000	float	Max total tax/fee USD
maxDuration optional	float	Max travel duration (hours)
minLayover default:0	float	Min layover (minutes)
maxLayover default:4320	float	Max layover (minutes)
noLoops default:false	bool	Disallow revisiting airports
nonstop default:false	bool	Direct-only mode. Forces `maxDepth=1` and excludes any route with stop/layover.

shield Cloud Run Safe Mode Constraints

To prevent Server OOMs within the free-tier 1vCPU/1Gi environment, the search engine automatically applies tighter constraints to broad queries to guarantee a response within 15 seconds. This may cause the engine to miss complex routes that a local unbounded search would find.

HTTP parsing hard limits: maxDepth must be 1-20, maxResults must be 1-10000, minStops must be 0-200.
Request timeout: backend context timeout is 15s.
Auto defaults - unconstrained: maxDepth up to 4, maxResults up to 200, maxLayover up to 480min.
Auto defaults - flight-only: maxDepth up to 3, maxResults up to 800, maxLayover up to 1440min.
Auto defaults - waypoints-only: maxDepth up to 6, maxResults up to 500, maxLayover up to 1440min.
Auto defaults - no origin: maxDepth up to 6, maxResults up to 1000, maxLayover up to 1440min.
Auto defaults - constrained with origin: default maxDepth 10, default maxResults 5000, default maxLayover 4320min.
Global hard caps: absolute maxResults 10000; exploration cap min(maxResults*2, 10000); per-DFS node cap 2,000,000.
Nonstop mode: nonstop=true forces maxDepth=1 and only keeps direct journeys without inherent layovers.

GET/api/airports

Returns list of all airports in the dataset.

GET/api/status

Returns scraper data refresh status.

GET/api/map

Returns a route map image proxied from Great Circle Mapper.

Parameter	Type	Description
path required	string	Route path, e.g. `SEA-DEN-MSP`

copyright

No routes found

API Documentation

shield Cloud Run Safe Mode Constraints