Proxy List

Proxy List

This section explains how to retrieve your datacenter proxies and how to fetch available continent filters. You can request proxies by subscription ID and optionally filter them by continent, country, and protocol. If all filter arrays are empty, all available proxies are returned in JSON format.

Get Proxies

Get Proxies

This endpoint returns your datacenter proxy list for a specific subscription. You can filter the result by continent IDs, country IDs, and protocols. If all filter arrays are empty, the full proxy list is returned.

POST/api/v1.0/subscriptions/{subscriptionId}/proxies
Limit: 10 requests / 60s
Required:subscriptionId
Important: Use the subscription "id": "su_69af..." from the subscription info response. Replace {subscriptionId} before sending the request.
Note: If continents, countries, and protocols are all empty arrays, all proxies for the subscription are returned. 
import requests, json


        def get_datacenter_proxies(subscription_id):

          url = f"https://api.ghostealth.com/dev/v1.0/subscriptions/{subscription_id}/proxies"

          headers = {"Content-Type": "application/json"}

          payload = {

            "continents": ["con_WOYCndD", "con_NA25c26"],

            "countries": [],

            "protocols": ["HTTPS", "SOCKS5"]

          }


          res = requests.post(url, headers=headers, json=payload)

          print("Get Proxies Response:", res.status_code)

          print(json.dumps(res.json(), indent=2))


        subscription_id = "su_69af3f2c91b24e8baf123456"

        get_datacenter_proxies(subscription_id)
Example Response:
Toggle Response
Datacenter Proxies Response: 200
        {
        "data": [
        {
        "id": "dp_69aa7e27c0caedeeb4dd6c06",
        "address": "93.186.201.14:20000",
        "host": "93.186.201.14",
        "port": 20000,
        "type": "DATACENTER",
        "protocol": "HTTPS",
        "encryption": "SSL",
        "anonymity": "ELITE",
        "continent": {
        "name": "World"
        }
        },
        {
        "id": "dp_69aa7e27c0caedeeb4dd6c07",
        "address": "93.186.201.14:20001",
        "host": "93.186.201.14",
        "port": 20001,
        "type": "DATACENTER",
        "protocol": "HTTPS",
        "encryption": "SSL",
        "anonymity": "ELITE",
        "continent": {
        "name": "World"
        }
        },
        (...)
        ]
        }
Note: Returned proxies are provided as JSON. Apply continent, country, or protocol filters to narrow the list.
Continents

Continents

This endpoint returns all available continent IDs that can be used in the proxy list filter request.

GET/api/v1.0/continents
Limit: 10 requests / 60s
Required:API-Key
Important: The returned continent id values are used in the continents array for the Get Proxies request. 
import requests, json


        def get_continents(api_key):

          url = "https://api.ghostealth.com/dev/v1.0/continents"

          headers = {

            "Content-Type": "application/json",

            "Authorization": f"ApiKey {api_key}"

          }


          res = requests.get(url, headers=headers)

          print("Continents Response:", res.status_code)

          print(json.dumps(res.json(), indent=2))


        api_key = "xxx"

        get_continents(api_key)
Example Response:
Toggle Response
Continents Response: 200
        {
        "data": [
        {
        "id": "con_WOYCndD",
        "code": "WO",
        "name": "World"
        },
        {
        "id": "con_EUn4OEo",
        "code": "EU",
        "name": "Europe"
        },
        {
        "id": "con_NA25c26",
        "code": "NA",
        "name": "North America"
        },
        ]
        }
Note: Available default continent IDs include con_WOYCndD for Worldwide, con_EUn4OEo for Europe, and con_NA25c26 for North America.