List proxies

List proxies

This endpoint returns the proxy list in paginated format. The mode parameter must always be specified.

Parameters

ParameterTypeDescription
modestring

Must be either direct or backbone. Required field. This field must be backbone if plan.pool_filter is residential.

country_code__instring

Filter by comma separated country code. Example filtering USA and French proxies: FR,US. Optional field.

searchstring

Filter by a search phrase. Can accept arbitrary text. Optional field. Search does not work in backbone mode.

orderingstring

Comma separated list of fields to specify ordering. Reverse ordering (DESC) can be achieved by adding minus in front of the field. Example: -valid,proxy_address. Optional field. Ordering is not supported in the backbone mode.

Request & Response

list_proxies.py
import requests
 
response = requests.get(
    "https://proxy.webshare.io/api/v2/proxy/list/?mode=direct&page=1&page_size=25",
    headers={"Authorization": "Token APIKEY"}
)
 
response.json()

Test this API

GET
{
  "count": 10,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "d-10513",
      "username": "username",
      "password": "password",
      "proxy_address": "1.2.3.4",
      "port": 8168,
      "valid": true,
      "last_verification": "2019-06-09T23:34:00.095501-07:00",
      "country_code": "US",
      "city_name": "New York",
      "created_at": "2022-06-14T11:58:10.246406-07:00"
    },
    ...
  ]
}