Proxy Lists

Your API key can access an HTTP proxy pool. qevron refreshes the pool from Webshare on a schedule (hourly by default) and serves it to your key. All endpoints are GET and authenticated with your API key.

Opt-in access

Access is opt-in: a key only receives proxies if it explicitly lists the pool name (e.g. proxy) in its allowed models. Keys that don't list the pool name get nothing.

Full proxy list

GET/v1/proxies

Returns the entire proxy pool your key can access.

curl https://app.qevron.ai/v1/proxies \
  -H "Authorization: Bearer $QEVRON_API_KEY"

Response

{
  "object": "list",
  "count": 100,
  "data": [
    {
      "host": "1.2.3.4",
      "port": 8080,
      "username": "user",
      "password": "pass",
      "proxy_url": "http://user:pass@1.2.3.4:8080"
    }
  ]
}

Field	Description
host	Proxy IP address.
port	Proxy port.
username	Proxy username.
password	Proxy password.
proxy_url	Ready-to-use URL with embedded credentials (http://user:pass@host:port).

Plain-text format

For piping directly into tools, use ?format=text to get raw host:port:username:password lines:

curl "https://app.qevron.ai/v1/proxies?format=text" \
  -H "Authorization: Bearer $QEVRON_API_KEY"

1.2.3.4:8080:user:pass
5.6.7.8:8080:user:pass

Single proxy (rotate)

GET/v1/proxies/rotate

Returns one proxy, round-robin per call.

curl https://app.qevron.ai/v1/proxies/rotate \
  -H "Authorization: Bearer $QEVRON_API_KEY"

{
  "host": "1.2.3.4",
  "port": 8080,
  "username": "user",
  "password": "pass",
  "proxy_url": "http://user:pass@1.2.3.4:8080"
}

• ?pool=<name> — picks a specific pool if you can access more than one.
• ?format=text — returns a single host:port:username:password line.
• Returns 404 no_proxy_available if your key has no accessible proxies.

Usage

Pass the proxy_url to any HTTP client:

PROXY=$(curl -s https://app.qevron.ai/v1/proxies/rotate \
  -H "Authorization: Bearer $QEVRON_API_KEY" | jq -r .proxy_url)
curl --proxy "$PROXY" https://api.ipify.org

TIP

The proxy list is refreshed server-side on a schedule; for long-running jobs, call /v1/proxies or /v1/proxies/rotate periodically to use the current pool.