Speed Test Summary

GET/api/v1/admin/proxy/speed-tests/summary

note

This endpoint requires Admin API Key authentication via the X-Admin-Key header.

Returns aggregated speed test statistics for all modems, useful for comparing carrier performance.

Query Parameters

location_idstring

Filter by location UUID

daysintegerdefault: 30

Number of days to analyze (1-365)

Response

period_daysinteger

Number of days analyzed

modem_countinteger

Number of modems included

modemsarray

Array of modem summaries with averages

Each modem summary contains:

• modem_id: Modem UUID
• carrier: Carrier name (e.g., "lifecell")
• last_download_mbps: Most recent download speed
• last_upload_mbps: Most recent upload speed
• last_latency_ms: Most recent latency
• last_speed_test_at: Timestamp of last test
• test_count: Number of tests in period
• avg_download_mbps: Average download speed
• avg_upload_mbps: Average upload speed
• avg_latency_ms: Average latency
• min_download_mbps: Minimum download speed
• max_download_mbps: Maximum download speed

Request Example

curl -X GET "https://spideriq.ai/api/v1/admin/proxy/speed-tests/summary?days=30" \
  -H "X-Admin-Key: your_admin_key"

import requests

response = requests.get(
    "https://spideriq.ai/api/v1/admin/proxy/speed-tests/summary",
    params={"days": 30},
    headers={"X-Admin-Key": "your_admin_key"}
)

# Find best performing carrier
for modem in response.json()["modems"]:
    print(f"{modem['carrier']}: {modem['avg_download_mbps']:.1f} Mbps avg")

Response Example

{
  "period_days": 30,
  "modem_count": 4,
  "modems": [
    {
      "modem_id": "11111111-1111-1111-1111-111111111111",
      "carrier": "lifecell",
      "last_download_mbps": 45.23,
      "last_upload_mbps": 12.87,
      "last_latency_ms": 42,
      "last_speed_test_at": "2026-01-05T03:00:00Z",
      "test_count": 30,
      "avg_download_mbps": 44.5,
      "avg_upload_mbps": 12.3,
      "avg_latency_ms": 43,
      "min_download_mbps": 35.2,
      "max_download_mbps": 52.1
    },
    {
      "modem_id": "22222222-2222-2222-2222-222222222222",
      "carrier": "MTS UKR",
      "last_download_mbps": 38.45,
      "last_upload_mbps": 10.23,
      "last_latency_ms": 55,
      "last_speed_test_at": "2026-01-05T03:00:00Z",
      "test_count": 30,
      "avg_download_mbps": 37.8,
      "avg_upload_mbps": 9.8,
      "avg_latency_ms": 58,
      "min_download_mbps": 28.5,
      "max_download_mbps": 45.2
    }
  ]
}

Use Cases

1. Carrier Comparison: Identify which carriers provide best performance
2. Performance Monitoring: Track speed degradation over time
3. Capacity Planning: Understand bandwidth availability per modem
4. SLA Verification: Ensure carriers meet expected speeds