Secure-VPN API
The public API gives read-only access to Secure-VPN test data. The location where a test starts is kept separate from the VPN exit location.
| Endpoint | Purpose |
|---|---|
/api/heatmap/options | Available test locations, VPN providers and protocols. |
/api/heatmap | Heatmap data by test location, VPN exit and UTC time block. |
/api/rankings | Provider and protocol rankings using exit locations shared by the VPN setups being compared. |
/api/compare | Compare two VPN setups using the same test location and shared VPN exits. |
Example: rankings
/api/rankings?worker_id=de1&timeframe=7d&min_samples=5&min_destinations=5
Example: compare two VPNs
/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
Ranking and comparison endpoints use only measurements that pass the benchmark quality checks. Different test locations are not mixed together, and each qualifying VPN exit gets equal weight instead of gaining influence simply because it was tested more often.