Residential Proxy List

Get Proxies

This endpoint returns residential proxies for a specific subscription slot. To make this request, you first need the subscriptionId and one valid slotId from the Residential Subscription Info endpoint. The subscription response contains the main subscription id and a slots array with all available slot IDs.

POST/api/v1.0/subscriptions/{subscriptionId}/slots/{slotId}/proxies
Limit: 10 requests / 60s
Required:subscriptionIdslotId
Important: Copy the subscription "id": "su_69af..." and one slot "id": "sl_69af..." from the Residential Subscription Info response. Replace {subscriptionId} and {slotId} in the URL before sending the request.
Note: Each active residential slot represents its own credential unit and stores its own proxy list. That means proxies are requested per slot, not once for the full subscription. 
import requests, json


        def get_residential_proxies(subscription_id, slot_id):

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

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


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

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

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


        subscription_id = "su_69afbaa5bc32119ad6daa8fe"

        slot_id = "sl_69afbaa5bc32119ad6daa900"

        get_residential_proxies(subscription_id, slot_id)
Example Response:
Toggle Response
Residential Proxies Response: 200
        {
        "data": [
        {
        "id": "rp_69b119f7f28cc7a9fe250901",
        "address": "148.251.5.30:10000",
        "host": "148.251.5.30",
        "port": 10000,
        "type": "RESIDENTIAL",
        "protocol": "HTTPS",
        "encryption": "SSL",
        "anonymity": "ELITE"
        },
        {
        "id": "rp_69b119f7f28cc7a9fe250902",
        "address": "148.251.5.30:10001",
        "host": "148.251.5.30",
        "port": 10001,
        "type": "RESIDENTIAL",
        "protocol": "HTTPS",
        "encryption": "SSL",
        "anonymity": "ELITE"
        },
        {
        "id": "rp_69b119f7f28cc7a9fe250903",
        "address": "148.251.5.30:10002",
        "host": "148.251.5.30",
        "port": 10002,
        "type": "RESIDENTIAL",
        "protocol": "HTTPS",
        "encryption": "SSL",
        "anonymity": "ELITE"
        },
        {
        "id": "rp_69b119f7f28cc7a9fe250904",
        "address": "148.251.5.30:10003",
        "host": "148.251.5.30",
        "port": 10003,
        "type": "RESIDENTIAL",
        "protocol": "HTTPS",
        "encryption": "SSL",
        "anonymity": "ELITE"
        },
        {
        "id": "rp_69b119f7f28cc7a9fe250905",
        "address": "148.251.5.30:10004",
        "host": "148.251.5.30",
        "port": 10004,
        "type": "RESIDENTIAL",
        "protocol": "HTTPS",
        "encryption": "SSL",
        "anonymity": "ELITE"
        }
        ]
        }