Stats

Endpoints for retrieving aggregated statistics and performance metrics. Requires speedtests:read token scope.

Fetch aggregated Speedtest statistics

get

Query parameters

start_atstring · date-timeOptional

Filter stats from this date/time (ISO 8601)

end_atstring · date-timeOptional

Filter stats up to this date/time (ISO 8601)

Header parameters

AcceptstringRequired

Must be "application/json" - this API only accepts and returns JSON

Default: application/json

Responses

200

Statistics fetched successfully

application/json

Aggregated speedtest statistics

total_resultsintegerOptional

avg_pingnumber · floatOptional

avg_downloadnumber · floatOptional

avg_uploadnumber · floatOptional

min_pingnumber · floatOptional

min_downloadnumber · floatOptional

min_uploadnumber · floatOptional

max_pingnumber · floatOptional

max_downloadnumber · floatOptional

max_uploadnumber · floatOptional

401

Unauthenticated

application/json

403

Forbidden

application/json

406

Not Acceptable - Missing or invalid Accept header

application/json

422

Validation error

application/json

get

/api/v1/stats

HTTPcURLJavaScriptPython

GET /api/v1/stats HTTP/1.1
Accept: application/json

{
  "total_results": 1,
  "avg_ping": 1,
  "avg_download": 1,
  "avg_upload": 1,
  "min_ping": 1,
  "min_download": 1,
  "min_upload": 1,
  "max_ping": 1,
  "max_download": 1,
  "max_upload": 1
}