Response Format - ClearProxy Documentation

Standard Check Response

{
  "summary": {
    "total_working": 2331,
    "countries": {
      "United States": 150,
      "Germany": 100
    },
    "anonymity_levels": {
      "elite": 200,
      "anonymous": 150,
      "transparent": 100
    },
    "top_isps": {
      "Digital Ocean": 50,
      "Amazon AWS": 45
    }
  },
  "metadata": {
    "job_id": "job_1769051242762_fmom13op5",
    "user": {
      "email": "hello@clearproxy.io",
      "checks_used": 1,
      "remaining_checks": 10938392,
      "subscription_detail": {
        "UnlimitedPro": false
      },
      "breakdown": {
        "root_balance": 10938392,
        "temp_balance": 0
      }
    },
    "region_used": "sg1",
    "region_name": "Singapore",
    "proxy_type": "http",
    "timeout_used": "5000ms",
    "total_checked": 1,
    "processing_time": "1.13s",
    "custom_validation_enabled": false
  },
  "result_url": "https://content.clearproxy.io/result/abc123.json?token=xyz"
}

Accessing Full Results

The result_url field contains a link to download the complete proxy check results. Access this URL to get detailed information about each proxy.

Standard Result Format

{
  "summary": {
    "total_working": 150,
    "countries": {
      "United States": 100,
      "Germany": 30,
      "United Kingdom": 20
    },
    "anonymity_levels": {
      "elite": 120,
      "anonymous": 20,
      "transparent": 10
    },
    "top_isps": {
      "Digital Ocean": 40,
      "Amazon AWS": 35,
      "Hetzner": 25
    }
  },
  "metadata": {
    "job_id": "job_1769051242762_fmom13op5",
    "user": {
      "email": "hello@clearproxy.io",
      "checks_used": 1,
      "remaining_checks": 10938392,
      "subscription_detail": {
        "UnlimitedPro": false
      },
      "breakdown": {
        "root_balance": 10938392,
        "temp_balance": 0
      }
    },
    "region_used": "sg1",
    "region_name": "Singapore",
    "proxy_type": "http",
    "timeout_used": "5000ms",
    "total_checked": 1,
    "processing_time": "1.13s",
    "custom_validation_enabled": false
  },
  "proxies": [
    {
      "proxy": {
        "host": "192.0.2.100",
        "port": 8080,
        "hasAuth": true,
        "username": "myuser",
        "password": "mypassword"
      },
      "status": "working",
      "statusCode": 200,
      "responseTime": "150 ms",
      "anonymity": "elite",
      "origin": "203.0.113.1",
      "country": "United States",
      "location": "New York",
      "isp": "Example ISP Inc.",
      "asn": 64512,
      "coordinates": {
        "lat": 40.7128,
        "lon": -74.006
      }
    },
    {
      "proxy": {
        "host": "198.51.100.50",
        "port": 3128,
        "hasAuth": false
      },
      "status": "working",
      "statusCode": 200,
      "responseTime": "220 ms",
      "anonymity": "elite",
      "origin": "198.51.100.50",
      "country": "Germany",
      "location": "Frankfurt",
      "isp": "Hetzner Online GmbH",
      "asn": 24940
    }
  ]
}

Custom URL Validation Response

When customUrls parameter is provided, the response includes additional validation results:

{
  "summary": {
    "total_working": 150,
    "countries": {...},
    "anonymity_levels": {...}
  },
  "metadata": {
    "job_id": "job_1769051242762_fmom13op5",
    "user": {
      "email": "hello@clearproxy.io",
      "checks_used": 1,
      "remaining_checks": 10938392,
      "subscription_detail": {
        "UnlimitedPro": false
      },
      "breakdown": {
        "root_balance": 10938392,
        "temp_balance": 0
      }
    },
    "region_used": "sg1",
    "region_name": "Singapore",
    "proxy_type": "http",
    "timeout_used": "5000ms",
    "total_checked": 1,
    "processing_time": "1.13s",
    "custom_validation_enabled": true,
    "custom_urls_tested": 2
  },
  "result_url": "https://content.clearproxy.io/result/custom_abc123.json?token=xyz",
  "custom_url_validation": {
    "summary": {
      "total_urls_tested": 2,
      "total_proxies_tested": 150,
      "processing_time": "8.45s"
    },
    "per_url_summary": [
      {
        "url": "https://discord.com",
        "success_count": 120,
        "failed_count": 30,
        "success_rate": "80.00%"
      },
      {
        "url": "https://example.com/api",
        "success_count": 90,
        "failed_count": 60,
        "success_rate": "60.00%"
      }
    ]
  }
}

Custom URL Result File

When custom URL validation is used, the file is saved with custom_ prefix:

{
  "summary": {...},
  "metadata": {
    "job_id": "job_1769051242762_fmom13op5",
    "user": {
      "email": "hello@clearproxy.io",
      "checks_used": 1,
      "remaining_checks": 10938392,
      "subscription_detail": {
        "UnlimitedPro": false
      },
      "breakdown": {
        "root_balance": 10938392,
        "temp_balance": 0
      }
    },
    "region_used": "sg1",
    "region_name": "Singapore",
    "proxy_type": "http",
    "timeout_used": "5000ms",
    "total_checked": 1,
    "processing_time": "1.13s",
    "custom_validation_enabled": true,
    "custom_urls_tested": 2
  },
  "proxies": [...],
  "custom_url_validation": {
    "total_urls_tested": 2,
    "total_proxies_tested": 150,
    "processing_time": "8.45s",
    "results": [
      {
        "url": "https://discord.com",
        "requiredStatusCodes": [200, 301],
        "requiredText": null,
        "caseSensitive": false,
        "total_tested": 150,
        "success_count": 120,
        "failed_count": 30,
        "success_rate": "80.00%",
        "successful_proxies": [
          {
            "proxy": {
              "host": "192.0.2.100",
              "port": 8080,
              "hasAuth": true,
              "username": "user",
              "password": "pass"
            },
            "status": "working",
            "statusCode": 200,
            "responseTime": "250 ms",
            "url": "https://discord.com"
          }
        ],
        "failed_proxies": [
          {
            "proxy": {
              "host": "203.0.113.1",
              "port": 8080
            },
            "status": "failed",
            "error": "timeout",
            "url": "https://discord.com"
          }
        ]
      }
    ]
  }
}