Get proxy stats

This endpoint retrieves the proxy stats. You need to add a query-string parameter plan_id.

GET https://proxy.webshare.io/api/v3/proxy/list/stats?plan_id=<PLAN-ID>

Request & Response

get_proxy_stats.py

import requests
 
response = requests.get(
  "https://proxy.webshare.io/api/v3/proxy/list/stats?plan_id=PLAN-ID",
  headers={ "Authorization": "Token APIKEY" }
)
 
response.json()

The commands above return JSON structured like this:

response.json

{
  "available_countries": {"US": 95},
  "ip_ranges_24": {"10.1.1.0/24": 5, "10.1.3.0/24": 100},
  "ip_ranges_16": {"10.1.0.0/16": 105},
  "ip_ranges_8": {"10.0.0.0/8": 105},
  "available_ip_ranges_24": {"1.2.3.0/24": 100},
  "available_ip_ranges_16": {"1.2.0.0/16": 100},
  "available_ip_ranges_8": {"1.0.0.0/8": 100},
  "asns": {"6137": ["ASN NAME", 105]},
  "available_asns": {"9421": ["ASN NAME", 105]}
}

Response fields

Each field maps a key (country code, IP range, or ASN) to the number of proxies in that group. Fields prefixed with available_ describe the proxy pool that the list can draw from, after excluding proxies already allocated to the list. Fields without the prefix describe the proxies currently allocated to the list.

Field	Type	Description
`available_countries`	`object`	Proxies in the pool that match the list filters (country selection, sources, ASNs, site checks) and are not yet allocated to this list, grouped by country code. This is the supply available for future allocations and replacements, not the current contents of the list.
`ip_ranges_24`	`object`	Proxies currently allocated to the list, grouped by /24 subnet.
`ip_ranges_16`	`object`	The same allocated proxies, aggregated into /16 subnets.
`ip_ranges_8`	`object`	The same allocated proxies, aggregated into /8 subnets.
`available_ip_ranges_24`	`object`	Proxies eligible as replacements, grouped by /24 subnet.
`available_ip_ranges_16`	`object`	Proxies eligible as replacements, grouped by /16 subnets.
`available_ip_ranges_8`	`object`	Proxies eligible as replacements, grouped by /8 subnets.
`asns`	`object`	Proxies currently allocated to the list, grouped by ASN. Each value is a tuple of ASN name and proxy count.
`available_asns`	`object`	Pool proxies available to the list htat are not yet allocated to this list, grouped by ASN. Each value is a tuple of ASN name and proxy count.

Proxy Configuration Get proxy status