proxy11

Official Node.js client for the Proxy11 proxy API.

Use it to fetch fresh proxy lists, filter by country or anonymity type, rotate through proxies, and export simple ip:port files.

Install

npm install proxy11

Quick Start

const { ProxyClient } = require("proxy11");

const client = new ProxyClient("YOUR_API_KEY");

const proxies = await client.get({ limit: 50, country: "us" });
const proxy = await client.random({ proxyType: "anonymous" });
const proxyList = await client.asList({ limit: 100 });

Examples

Get Proxies

const proxies = await client.get({
  limit: 50,
  country: "us",
  proxyType: "anonymous",
  speed: 1.0,
});

Get ip:port List

const proxies = await client.asList({ limit: 50 });
// ["103.152.112.166:8080", "45.77.56.114:4145"]

Random Proxy

const proxy = await client.random({ country: "us" });
const proxyDetails = await client.randomProxy();

Save to File

const count = await client.save("proxies.txt", { country: "us" });
console.log(`saved ${count} proxies`);

Rotator

const rotator = await client.rotator({
  country: "us",
  proxyType: "anonymous",
  autoRefresh: true,
  refreshAfter: 50,
});

for (let i = 0; i < 100; i += 1) {
  const proxy = await rotator.next();
  console.log(proxy);
  // if proxy fails:
  // rotator.markDead(proxy);
}

Error Handling

const { APIError, NoProxiesError, ProxyClient } = require("proxy11");

const client = new ProxyClient("YOUR_API_KEY");

try {
  const proxy = await client.random({ country: "us" });
  console.log(proxy);
} catch (error) {
  if (error instanceof NoProxiesError) {
    console.log("No proxies matched the filters");
  } else if (error instanceof APIError) {
    console.log(`Proxy11 API error: ${error.message}`);
  } else {
    throw error;
  }
}

API

Method	Description
get(filters)	Return proxy rows as objects
asList(filters)	Return proxies as ip:port strings
random(filters)	Return one random ip:port proxy
randomProxy(filters)	Return one random proxy object
save(path, filters)	Save ip:port proxies to a file
rotator(filters)	Create an async proxy rotator

Filters

Parameter	Type	Description
limit	number	Max proxies to return, capped by your plan
country	string	Country name or two-letter country code
port	number	Proxy port
speed	number	Max response time in seconds
proxyType	string	anonymous or transparent

Links

• Website: proxy11.com
• API docs: proxy11.com/apidoc
• SDK page: proxy11.com/sdk

License

MIT