GET
https://spideriq.ai
/
api
/
v1
/
admin
/
proxy
/
modems
/
{modem_id}
/
traffic-stats
curl -X GET "https://spideriq.ai/api/v1/admin/proxy/modems/{modem_id}/traffic-stats?days=7" \
  -H "X-Admin-Key: your_admin_key"
{
  "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
    }
  ]
}
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_id
string
required
UUID of the modem

Query Parameters

days
integer
default:"30"
Number of days of history (1-365)

Response

modem_id
string
required
UUID of the modem
carrier
string
required
Carrier name (e.g., “lifecell”)
summary
object
required
Aggregated statistics for the period
current
object
required
Today’s and lifetime counters
daily_stats
array
required
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
curl -X GET "https://spideriq.ai/api/v1/admin/proxy/modems/{modem_id}/traffic-stats?days=7" \
  -H "X-Admin-Key: your_admin_key"
{
  "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
    }
  ]
}