Benchmark API
Public analytics endpoints expose QC-rankable benchmark data while keeping the physical source worker separate from the VPN destination.
| Endpoint | Purpose |
|---|---|
/api/heatmap/options | Available workers, providers and protocols. |
/api/heatmap | Source × destination × UTC-hour heatmap with raw and display retention. |
/api/rankings | Coverage-balanced provider/protocol ranking on a shared destination intersection. |
/api/compare | Same-worker, same-destination comparison of two provider/protocol pairs. |
Ranking example
/api/rankings?worker_id=de1&timeframe=7d&min_samples=5&min_destinations=5
Comparison example
/api/compare?worker_id=de1&provider_a=expressvpn&protocol_a=lightway_udp&provider_b=nordvpn&protocol_b=nordlynx_udp&timeframe=7d&min_samples=3&min_destinations=3
Both endpoints use measurement_quality.rankable = TRUE. Rankings never mix source workers. Overall scores give every eligible destination equal weight instead of weighting destinations by measurement volume.