This data call 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.

https://stat.ripe.net/data/mlab-clients/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/mlab-clients/data.json?resource=193.0.0.0/16&starttime=2013-08-21T07:00&endtime=2013-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

Output

Data

Key	Info
clients	A key-value list of hosts with network activity, indexed by the host IP address. Each record has the following format. num_tests The number of tests ran by the host during the query period. country The country where the host is located (according to Maxmind data). city The city where the host is located (according to Maxmind data). latitude The host latitude according to Maxmind data. longitude The host longitude according to Maxmind data.
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.

Example

    "data": {
         "clients": { 
            "193.0.166.77": {
                "city": "", 
                "country": "DE", 
                "latitude": 51.0, 
                "longitude": 9.0, 
                "num_tests": 6
            }, 
            "193.0.167.169": {
                "city": "", 
                "country": "DE", 
                "latitude": 51.0, 
                "longitude": 9.0, 
                "num_tests": 3
            },
            "193.0.200.27": {
                "city": "", 
                "country": "RU", 
                "latitude": 60.0, 
                "longitude": 100.0, 
                "num_tests": 6
            },
            [...]
        },
        "nr_clients": 6, 
        "perc_coverage": 0.0091552734375, 
        "query_endtime": "2013-08-29T23:59:59", 
        "query_starttime": "2013-08-21T07:00:00", 
        "resource": "193.0.0.0/16" 
    }