ProxyGlide API

REST API for listing proxies, rotating 4G mobile IPs and reading usage stats. Designed for crawlers, monitoring systems and CI pipelines — plain HTTP, clean JSON, scoped bearer keys.

Base URL: https://api.proxyglide.io/v1 · Rate limit: 60 req/min per key (30 rotations/min). Need higher limits? Contact sales.

Authentication

All requests use a bearer token. Create a key at /dashboard/api-keys. Keys follow the format mp_<prefix>_<secret> and have per-request scopes.

bash

curl https://api.proxyglide.io/v1/proxies \
  -H "Authorization: Bearer mp_abcd1234_xxxxxxxxxxxxxxxxxxxx"

Scopes

proxy:read — list and read proxy details
proxy:rotate — trigger IP rotation
stats:read — read usage statistics

List proxies

GET /v1/proxies · scope: proxy:read

bash

curl https://api.proxyglide.io/v1/proxies \
  -H "Authorization: Bearer $MOBIPROXY_KEY"

json

{
  "data": [
    {
      "id": "ckq...",
      "country": "FR",
      "host": "gateway.proxyglide.io",
      "port": 10234,
      "username": "u_0a1b2c3d4e5f",
      "password": "Qx8pR...",
      "protocol": "http",
      "status": "ACTIVE",
      "currentIp": "45.12.34.56",
      "lastRotatedAt": "2026-04-21T08:12:30.000Z",
      "expiresAt": "2026-05-21T00:00:00.000Z"
    }
  ]
}

Get proxy

GET /v1/proxies/:id · scope: proxy:read

bash

curl https://api.proxyglide.io/v1/proxies/ckq... \
  -H "Authorization: Bearer $MOBIPROXY_KEY"

Rotate IP

POST /v1/proxies/:id/rotate · scope: proxy:rotate

Requests a fresh carrier IP. Typically completes in under 30 seconds. Rate-limited to 30 rotations per minute per API key.

bash

curl -X POST https://api.proxyglide.io/v1/proxies/ckq.../rotate \
  -H "Authorization: Bearer $MOBIPROXY_KEY"

json

{
  "ok": true,
  "proxyId": "ckq...",
  "oldIp": "45.12.34.56",
  "newIp": "45.34.87.12",
  "rotatedAt": "2026-04-21T08:15:02.000Z"
}

Usage stats

GET /v1/usage?days=30 · scope: stats:read

Returns aggregated bytes and request counts per proxy. days is between 1 and 90 (default 30).

json

{
  "since": "2026-03-22T00:00:00.000Z",
  "days": 30,
  "byProxy": [
    { "proxyId": "ckq...", "bytesIn": 1250000000, "bytesOut": 342000000, "requests": 18420 }
  ]
}

Errors

Status	Code	Meaning
`401`	`missing_bearer` / `invalid_key`	No/invalid API key
`403`	`insufficient_scope`	Key lacks the required scope
`404`	`not_found`	Resource missing or not yours
`409`	`proxy_not_active`	Proxy suspended or revoked
`429`	`rate_limited`	Too many requests; check `retryAfterMs`
`502`	`rotation_failed`	Modem unreachable, retry