Get Proxy Pool Stats

GET/api/v1/admin/proxy/stats

note

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

Response

total_locationsinteger

Total number of registered locations

online_locationsinteger

Number of locations currently online

total_modemsinteger

Total number of registered modems

online_modemsinteger

Number of modems currently online

healthy_modemsinteger

Number of modems healthy and ready for traffic

total_iphonesinteger

Total number of registered iPhones (SpideriPhone)

online_iphonesinteger

Number of iPhones currently online

total_devicesinteger

Total devices (modems + iPhones)

healthy_devicesinteger

Total healthy devices ready for traffic

total_requests_todayinteger

Total proxy requests processed today

total_rotations_todayinteger

Total IP rotations performed today

by_countryobject

Device count breakdown by country code

Example

{
  "UA": 4,
  "US": 2
}

by_device_typeobject

Device count breakdown by type

Example

{
  "modem": 4,
  "iphone": 0
}

Request Example

curl -X GET "https://spideriq.ai/api/v1/admin/proxy/stats" \
  -H "X-Admin-Key: your_admin_key"

import requests

response = requests.get(
    "https://spideriq.ai/api/v1/admin/proxy/stats",
    headers={"X-Admin-Key": "your_admin_key"}
)
stats = response.json()
print(f"Healthy proxies: {stats['healthy_devices']}/{stats['total_devices']}")

Response Example

{
  "total_locations": 1,
  "online_locations": 1,
  "total_modems": 4,
  "online_modems": 4,
  "healthy_modems": 4,
  "total_iphones": 0,
  "online_iphones": 0,
  "healthy_iphones": 0,
  "total_devices": 4,
  "healthy_devices": 4,
  "total_requests_today": 0,
  "total_rotations_today": 0,
  "by_country": {
    "UA": 4
  },
  "by_device_type": {
    "modem": 4,
    "iphone": 0
  }
}