beta

API

Every page is built from these endpoints. Send an API key as Authorization: Bearer vpndb_…; create one under Account.

This page

GET /api/v1/meta

curl -s -H 'Authorization: Bearer vpndb_EXAMPLE_NOT_A_REAL_KEY' \
  '/api/v1/meta'

All endpoints

GET /api/v1/ip/{ip}Who operates an address
GET /api/v1/ip/{ip}/historyEvery week of an address
GET /api/v1/prefix/{cidr}Any range, and who is inside it
GET /api/v1/prefix/{cidr}/addressesEvery address of a prefix, in a window
GET /api/v1/prefix/{cidr}/timelineHow a prefix was probed, day by day
GET /api/v1/asn/{asn}A network and its providers
GET /api/v1/asn/{asn}/networksEvery prefix of a network
GET /api/v1/org/{id}A company and all its networks
GET /api/v1/org/{id}/networksEvery prefix of a company
GET /api/v1/country/{cc}The infrastructure located in a country
GET /api/v1/countriesEvery country at a glance
GET /api/v1/service/{tag}A provider's profile
GET /api/v1/service/{tag}/networksEvery network a provider exits from
GET /api/v1/servicesEvery provider at a glance
GET /api/v1/torThe Tor network at a glance
GET /api/v1/tor/relaysEvery running Tor relay, for detection
POST /api/v1/bulkMany addresses at once
GET /api/v1/searchResolve free text
GET /api/v1/suggestSuggestions as you type
GET /api/v1/metaThe dataset
GET /api/v1/openapi.yamlThis specification
GET /api/v1/sourcesWhere the data comes from
API documentationOpenAPI specification
Sign in

Evidence

What each number counts

Every figure the product and the API publish, with what it counts, over which time and where else it appears.

The same word can stand for different counts: providers active this month or every provider ever seen, addresses seen in 30 days or over the whole record. Each figure below is named for what it counts, and the same figure has the same value wherever it appears. Every figure is computed after each sync; datasetVersion names that moment.

FigureWhat it countsWhere
Exit addresses, 30 daysDistinct exit addresses from all sources together, last seen in the 30 days before the data state/meta counts.exitIps30d
Exit addresses, all timeDistinct exit addresses from all sources together, since November 2024/meta counts.exitIpsAllTime; the sum of the providers page's known addresses counts each address once
Providers active, 30 daysProviders with at least one exit address seen in the 30 days, VPN and proxy/meta counts.providersActive30d = vpnServices + proxyServices; /services counts.active30d; start page
Providers observedEvery provider the record names, also those no longer probed and those known from the snapshot or a certificate only/meta counts.providersObserved; /services counts.providers; providers page
Addresses with a verdictAddresses a lookup answers as VPN or proxy: measured, interpolated from VPN exits at low confidence or better, or named by an external list/meta counts.addressesWithVerdict; start page, under the headline
Addresses in networks with residential proxy activityUnobserved addresses in announced prefixes where at least 1 % were measured as residential proxy exits; context, no verdict/meta counts.addressesInResidentialProxyNetworks; start page, under the headline
Addresses with VPN or proxy evidenceThe two above added: the start page's headline/meta counts.addressesWithEvidence; start page

Two counting rules run through the figures. Sums over addresses count each address once, for its most recent sighting, so they add up. Per provider figures count every address a provider was seen on in any source, so an address two providers shared counts for both, and the providers' figures add up to more than the total. The coverage figure explains the layers of the headline.