Node.js SDK

npm i clearproxy

import { ClearProxy } from "clearproxy";
import fs from "fs";

const client = new ClearProxy("clearpx_yourkey");

(async () => {
  const result = await client.check("proxies.txt", {
    region: "us1",
    timeout: 4000,
    type: "http"
  });

  console.log("Summary:", result.summary);
  console.log("Working:", result.working.length);

  // Save to file
  fs.writeFileSync("working.txt", client.export(result.working, "txt", true));
})();

import { ClearProxy } from "clearproxy";

const client = new ClearProxy("clearpx_yourkey");

(async () => {
  const result = await client.check("proxies.txt", {
    region: "us1",
    timeout: 5000,
    type: "http",
    customUrls: [
      {
        url: "https://discord.com",
        requiredStatusCodes: [200, 301, 302]
      },
      {
        url: "https://www.google.com",
        requiredStatusCodes: [200],
        requiredText: "Search",
        caseSensitive: false
      }
    ]
  });

  // Access custom validation results
  console.log("Custom Validation:", result.custom_url_validation);
  
  // Get summary
  const summary = client.getCustomUrlSummary(result);
  console.log("Overall success rate:", summary.overall_success_rate);
  
  // Filter by specific URL
  const discordProxies = client.filterByCustomUrl(result, "https://discord.com");
  console.log("Discord working proxies:", discordProxies.length);
})();

const result = await client.check("proxies.txt", {
  region: "us1",
  timeout: 5000,
  type: "http",
  customUrls: [
    { url: "https://example.com", requiredStatusCodes: [200] }
  ]
});

const exported = client.export(result.working, "txt", true);
fs.writeFileSync("working.txt", exported);

const discordProxies = client.filterByCustomUrl(result, "https://discord.com");
console.log(`Found ${discordProxies.length} working Discord proxies`);

const summary = client.getCustomUrlSummary(result);
console.log(`Total URLs: ${summary.total_urls}`);
console.log(`Success rate: ${summary.overall_success_rate}`);
console.log(`Per-URL:`, summary.per_url);

{
  total_urls: 2,
  total_proxies_tested: 150,
  total_success: 210,
  total_failed: 90,
  overall_success_rate: "70.00%",
  per_url: [
    {
      url: "https://discord.com",
      success_count: 120,
      failed_count: 30,
      success_rate: "80.00%"
    },
    {
      url: "https://www.google.com",
      success_count: 90,
      failed_count: 60,
      success_rate: "60.00%"
    }
  ]
}

const account = await client.me();
console.log(`Checks remaining: ${account.user.checks}`);

const regions = await client.regions();
console.log("Available regions:", regions);

const health = await client.health();
console.log("API status:", health.status);

{
  summary: {
    total_working: 150,
    countries: { "United States": 100, "Germany": 30, "United Kingdom": 20 },
    anonymity_levels: { elite: 120, anonymous: 20, transparent: 10 }
  },
  metadata: {
    user: {
      email: "[email protected]",
      checks_used: 500,
      remaining_checks: 4500
    },
    region_used: "us1",
    proxy_type: "http",
    timeout_used: "5000ms",
    total_checked: 500,
    processing_time: "8.32s"
  },
  proxies: [
    {
      proxy: {
        host: "67.67.67.67",
        port: 80,
        hasAuth: false
      },
      status: "working",
      statusCode: 200,
      responseTime: "1549.48 ms",
      anonymity: "anonymous",
      origin: "67.67.67.67",
      country: "ID",
      location: "Jakarta",
      isp: "Six Seven LLC",
      asn: 6767
    }
  ],
  working: [...], // Array of working proxies
  failed: [...],  // Array of failed proxies
  custom_url_validation: null // or validation results if customUrls provided
}

{
  // ... standard response fields above ...
  custom_url_validation: {
    summary: {
      total_urls_tested: 2,
      total_proxies_tested: 150,
      processing_time: "8.45s"
    },
    per_url_summary: [
      {
        url: "https://discord.com",
        total_tested: 150,
        success_count: 120,
        failed_count: 30,
        success_rate: "80.00%",
        requiredStatusCodes: [200, 301, 302],
        successful_proxies: [
          {
            proxy: "192.168.1.1:8080",
            status: "working",
            statusCode: 200,
            responseTime: "250ms"
          }
        ],
        failed_proxies: [...]
      },
      {
        url: "https://www.google.com",
        total_tested: 150,
        success_count: 90,
        failed_count: 60,
        success_rate: "60.00%",
        requiredStatusCodes: [200],
        requiredText: "Search",
        caseSensitive: false,
        successful_proxies: [...],
        failed_proxies: [...]
      }
    ]
  }
}

import { ClearProxy } from "clearproxy";

const client = new ClearProxy("clearpx_yourkey");

const result = await client.check("proxies.txt", {
  region: "us1",
  timeout: 4000,
  type: "http"
});

console.log(`Working: ${result.working.length}`);
console.log(`Failed: ${result.failed.length}`);

const result = await client.check("proxies.txt", {
  region: "us1",
  customUrls: [
    {
      url: "https://discord.com",
      requiredStatusCodes: [200, 301, 302]
    }
  ]
});

const discordProxies = client.filterByCustomUrl(result, "https://discord.com");
console.log(`Discord working proxies: ${discordProxies.length}`);

// Export to file
const exported = client.export(discordProxies, "txt", true);
fs.writeFileSync("discord-proxies.txt", exported);

const result = await client.check("proxies.txt", {
  region: "us1",
  timeout: 6000,
  customUrls: [
    { url: "https://discord.com", requiredStatusCodes: [200, 301, 302] },
    { url: "https://twitter.com", requiredStatusCodes: [200] },
    { url: "https://instagram.com", requiredStatusCodes: [200, 302] }
  ]
});

// Get overall summary
const summary = client.getCustomUrlSummary(result);
console.log(`Overall success rate: ${summary.overall_success_rate}`);

// Get proxies for each platform
const discordProxies = client.filterByCustomUrl(result, "https://discord.com");
const twitterProxies = client.filterByCustomUrl(result, "https://twitter.com");
const instagramProxies = client.filterByCustomUrl(result, "https://instagram.com");

console.log(`Discord: ${discordProxies.length}`);
console.log(`Twitter: ${twitterProxies.length}`);
console.log(`Instagram: ${instagramProxies.length}`);

try {
  const result = await client.check("proxies.txt", {
    region: "us1",
    customUrls: [
      { url: "https://example.com" }
    ]
  });
  
  console.log("Check completed:", result.summary);
} catch (error) {
  if (error.message.includes('API Error')) {
    console.error("API error:", error.message);
  } else if (error.message.includes('No proxies found')) {
    console.error("Invalid proxy file");
  } else {
    console.error("Unexpected error:", error);
  }
}