Skip to main content

Traffic Stats

GET/api/v1/admin/proxy/modems/{modem_id}/traffic-stats
note

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

Returns detailed traffic history for a specific modem, including daily breakdowns of requests, bytes, and uptime.

Path Parameters​

modem_idstringrequired

UUID of the modem

Query Parameters​

daysintegerdefault: 30

Number of days of history (1-365)

Response​

modem_idstring

UUID of the modem

carrierstring

Carrier name (e.g., "lifecell")

summaryobject

Aggregated statistics for the period

currentobject

Today's and lifetime counters

daily_statsarray

Day-by-day breakdown

Summary Fields​

  • total_requests: Total requests in period
  • failed_requests: Failed requests in period
  • success_rate: Success percentage
  • total_bytes_gb: Data transferred in GB
  • total_rotations: IP rotations performed
  • avg_requests_per_day: Average daily requests
  • avg_bytes_per_day_mb: Average daily data in MB

Current Fields​

  • requests_today: Today's request count
  • bytes_today: Today's bytes transferred
  • rotations_today: Today's rotation count
  • requests_total: Lifetime requests
  • bytes_total: Lifetime bytes

Daily Stats Fields​

  • date: Date (YYYY-MM-DD)
  • requests: Request count
  • failed_requests: Failed request count
  • bytes_mb: Data transferred in MB
  • rotations: IP rotations
  • uptime_hours: Hours online

Request Example

curl -X GET "https://spideriq.ai/api/v1/admin/proxy/modems/{modem_id}/traffic-stats?days=7" \
  -H "X-Admin-Key: your_admin_key"
import requests

modem_id = "11111111-1111-1111-1111-111111111111"
response = requests.get(
    f"https://spideriq.ai/api/v1/admin/proxy/modems/{modem_id}/traffic-stats",
    params={"days": 7},
    headers={"X-Admin-Key": "your_admin_key"}
)
stats = response.json()
print(f"Success rate: {stats['summary']['success_rate']}%")
print(f"Total data: {stats['summary']['total_bytes_gb']} GB")

Response Example

{
  "modem_id": "11111111-1111-1111-1111-111111111111",
  "carrier": "lifecell",
  "summary": {
    "total_requests": 45000,
    "failed_requests": 90,
    "success_rate": 99.8,
    "total_bytes_gb": 12.5,
    "total_rotations": 168,
    "avg_requests_per_day": 6428,
    "avg_bytes_per_day_mb": 1830
  },
  "current": {
    "requests_today": 1523,
    "bytes_today": 423567890,
    "rotations_today": 24,
    "requests_total": 892345,
    "bytes_total": 245678901234
  },
  "daily_stats": [
    {
      "date": "2026-01-05",
      "requests": 1200,
      "failed_requests": 12,
      "bytes_mb": 350.5,
      "rotations": 24,
      "uptime_hours": 23.8
    },
    {
      "date": "2026-01-04",
      "requests": 1500,
      "failed_requests": 15,
      "bytes_mb": 420.3,
      "rotations": 24,
      "uptime_hours": 24.0
    }
  ]
}