Proxy List API documentation

Authentication

Authentication is by account email — no separate key. Pass the email of an active subscription on every request.

email must belong to an active plan. Don't have one yet? Get proxies →

Quick start

Request 50 elite SOCKS5 proxies from the US or France, as JSON.

curl "https://www.proxydocker.com/proxylist/api?email=you@example.com&format=json\
&country=us,fr&type=socks5&anonymity=elite&limit=50"

import requests

resp = requests.get(
    "https://www.proxydocker.com/proxylist/api",
    params={
        "email": "you@example.com",
        "format": "json",
        "country": "us,fr",
        "type": "socks5",
        "anonymity": "elite",
        "limit": 50,
    },
    timeout=30,
)
proxies = resp.json()["Proxies"]

for p in proxies:
    print(f"{p['ip']}:{p['port']}", p["type"], p["country"])

Parameters

All parameters are optional except email, and can be combined freely.

Parameter	Values	Description
`email`required	account email	Must belong to an active subscription.
`format`	`text` · `json`	Output format. Defaults to text.
`country`	`us,fr`	Filter by country (comma-separated).
`city`	city name	Filter by city.
`type`	`http` · `https` · `socks4` · `socks5`	Protocol (comma-separated).
`port`	port number	Filter by port.
`anonymity`	`transparent` · `anonymous` · `elite`	Anonymity level.
`state`	region / state	Filter by region.
`timeout`	milliseconds	Only proxies at or below this response time.
`limit`	`1 – 10000`	How many proxies to return. Defaults to 10000.

Response

With format=json you get a Proxies array. With format=text you get one ip:port per line.

{
  "Proxies": [
    {
      "ip": "188.34.22.10",
      "port": 1080,
      "type": "SOCKS5",
      "country": "United States",
      "code": "US",
      "city": "Ashburn",
      "anonymity": "elite",
      "timeout": 420
    }
  ]
}

Only proxies checked within the last 7 days are returned, newest first.

Errors

A missing/invalid email or an expired plan returns HTTP 200 with a Notice and an empty list:

{ "Notice": "Your package is already expired.", "Proxies": [] }

Up to 10,000 requests per day per account.
The same data is available at /proxylist/download and /proxylist/v2/api.