M-lab Clients
This endpoint returns a set of all the hosts within a certain resource for which any network tests occurred.
The data is based on active host measurements collected by the Measurement Lab platform (M-Lab).
The measurements are commonly ran using the M-Lab Network Detection Tool (NDT), available as a stand-alone network speed test application, and also included in a popular BitTorrent client.
Note that due to the nature the data is processed data can be delayed for around two days at the beginning of each month!
The results published, including host details are covered by the M-Lab acceptable use policy.
GET /data/mlab-clients/data.json?resource=193.0.0.0/16&starttime=2020-08-21T07:00&endtime=2020-18-27T12:00
Parameters
| Key | Value | Info | Required |
|---|---|---|---|
| resource | IPv4 Prefix, IPv4 address or 2-digit ISO-3166 country code (e.g. "at","de"...) | Defines the resource that the query is performed for. | YES |
| starttime | ISO8601 or Unix timestamp | Defines the starttime for the query | NO - default: (endtime - 7d) |
| endtime | ISO8601 or Unix timestamp | Defines the endtime for the query | NO - default: latest time there is M-Lab data available |
Data Output
| Key | Info | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| clients | A key-value list of hosts with network activity, indexed by the host IP address. Each record has the following format.
| ||||||||||
| nr_clients | Total number of hosts in the result. | ||||||||||
| perc_coverage | (Only applicable for prefixes). The amount of address space coverage of the hosts. Equals to nr_clients/number of IPs in the prefix. | ||||||||||
| query_starttime | Defines the start of the time interval covered in the query. | ||||||||||
| query_endtime | Defines the end of the time interval covered in the query. | ||||||||||
| resource | Defines the resource used in the query. |
Code Examples
bash
curl --location --request GET "https://stat.ripe.net/data/mlab-clients/data.json?resource=193.0.0.0/16&starttime=2020-08-21T07:00&endtime=2020-18-27T12:00"js
const requestOptions = {
method: 'GET',
};
fetch("https://stat.ripe.net/data/mlab-clients/data.json?resource=193.0.0.0/16&starttime=2020-08-21T07:00&endtime=2020-18-27T12:00", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));