Proxy List

Proxy List

This endpoint returns proxies from the proxy scraper tool. You can filter the result by port, uptime, checked timestamp, continent, country, protocol, anonymity, and speed. If all filter fields are empty, all proxies are returned.

Get Proxies

Get Proxies

This endpoint returns scraped proxies in JSON format. Pagination is controlled through the query string, while filters are passed in the request body.

POST/api/v1.0/tools/proxy-scraper/proxies?page=0&size=20&sortBy=id&direction=DESC
Limit: 10 requests / 60s
Required:API-Key
Important: To retrieve all proxies at once, leave all filter parameters empty and set size=2000 in the query string.
Note: If all filters are empty, the endpoint returns all available scraped proxies. 
import requests, json


        def get_scraper_proxies(api_key):

          url = "https://api.ghostealth.com/dev/v1.0/tools/proxy-scraper/proxies?page=0&size=20&sortBy=id&direction=DESC"

          headers = {

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

            "Authorization": f"ApiKey {api_key}"

          }

          payload = {

            "port": None,

            "uptime": 90,

            "checkedAfterTimestamp": 1770120548000,

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

            "countries": [],

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

            "anonymities": ["ELITE", "ANONYMOUS", "TRANSPARENT"],

            "speeds": ["SLOW", "MEDIUM", "FAST"]

          }


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

          print("Proxy Scraper Response:", res.status_code)

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


        api_key = "xxx"

        get_scraper_proxies(api_key)
Example Response:
Toggle Response
Proxy Scraper Proxies Response: 200
        {
        "data": [
        {
        "id": "fp_69b1395f7d16bed7023855c8",
        "pid": "FP-WESY-55C8",
        "audit": {
        "createdAt": {
        "timestamp": 1773222239011,
        "date": 1773222239011
        }
        },
        "address": "202.93.245.34:1111",
        "host": "202.93.245.34",
        "port": 1111,
        "type": "DATACENTER",
        "protocol": "HTTPS",
        "encryption": "NO_SSL",
        "anonymity": "TRANSPARENT",
        "statistic": {
        "uptime": 9.491525423728813,
        "latency": 8791.315078735352,
        "speed": "SLOW"
        },
        "continent": {
        "name": "Asia"
        },
        "country": {
        "name": "Indonesia",
        "code": "ID"
        }
        },
        {
        "id": "fp_69b1395f7d16bed7023855c7",
        "pid": "FP-RDTN-55C7",
        "audit": {
        "createdAt": {
        "timestamp": 1773222239007,
        "date": 1773222239007
        }
        },
        "address": "165.225.113.220:10958",
        "host": "165.225.113.220",
        "port": 10958,
        "type": "DATACENTER",
        "protocol": "HTTPS",
        "encryption": "NO_SSL",
        "anonymity": "ELITE",
        "statistic": {
        "uptime": 8.588957055214724,
        "latency": 534.8083972930908,
        "speed": "MEDIUM"
        },
        "continent": {
        "name": "Asia"
        },
        "country": {
        "name": "Singapore",
        "code": "SG"
        }
        },
        (...)
        ]
        }
Continents

Continents

Use the continents array to filter proxies by continent IDs such as Worldwide, Europe, or North America.

Note: Example continent IDs include con_WOYCndD for Worldwide and con_NA25c26 for North America.
Protocols

Protocols

Use the protocols array to filter by supported proxy protocols, such as HTTPS and SOCKS5.

Note: Multiple protocols can be combined in the same request.
Anonymities

Anonymities

Use the anonymities array to filter proxies by anonymity level, including ELITE, ANONYMOUS, and TRANSPARENT.

Note: Elite proxies provide the highest privacy level, while transparent proxies expose more client details.
Uptime

Uptime

Use the uptime field to only return proxies with a minimum uptime percentage.

Note: For example, setting uptime to 90 only returns proxies with at least 90% uptime.
Speed

Speed

Use the speeds array to filter proxies by performance category: SLOW, MEDIUM, or FAST.

Note: Combine speed filters with uptime and protocol filters for more targeted results.