Generate proxies

curl --request GET \
  --url https://www.eclipseproxy.com/api/genProxy

import requests

url = "https://www.eclipseproxy.com/api/genProxy"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://www.eclipseproxy.com/api/genProxy', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.eclipseproxy.com/api/genProxy"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

GET

api

genProxy

Generate proxies

curl --request GET \
  --url https://www.eclipseproxy.com/api/genProxy

import requests

url = "https://www.eclipseproxy.com/api/genProxy"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://www.eclipseproxy.com/api/genProxy', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.eclipseproxy.com/api/genProxy"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Turn a single proxy template (with whatever targeting and session settings you want) into a list of formatted proxy strings.

No authentication required. genProxy is a pure formatter — it expands your template into the requested count and output format. It does not validate your credentials, your targeting, or that the resulting proxies actually work; it just reformats whatever template you pass in. Test the output with a real request (see Quickstart).

Query parameters

proxy

string

required

URL-encoded proxy template in the form username:password:host:port. The username can contain all the geo/session/ASN segments you want: see Residential setup.The port in the template determines the session type. The example below uses :10000 (sticky) with a -session- segment. For rotating proxies, use the rotating port (:9000 for Residential HTTP) and omit the -session- segment. See Residential ports.

format

string

required

Output format string. Token reference: , h → host , pt → port , u → username , ps → passwordExamples: h:pt:u:ps produces host:port:username:password.

amount

number

required

Number of proxies to return. Maximum 1000 per request (the response is capped at 1000 lines). To generate more, page across multiple calls — e.g. vary the -session- segment per batch.

Example request

curl "https://www.eclipseproxy.com/api/genProxy?\
proxy=eclipse_yourname-country-kh-state-phnompenh-asn-38901-session-session123-lifetime-30%3A8d5c90c2-3f3d-4061-be8e-579c49e0fa7a%3Acore.eclipseproxy.com%3A10000\
&format=h:pt:u:ps\
&amount=10"

The %3A is URL-encoded :: needed because the proxy template itself contains colons.

Response format

The response is plain text (text/plain), one proxy per line, newline-delimited — not JSON. Split on newlines to get the list (this is why the examples below use .text.splitlines() / .split("\n")).

core.eclipseproxy.com:10000:eclipse_yourname-country-kh-...:8d5c90c2-...
core.eclipseproxy.com:10000:eclipse_yourname-country-kh-...:8d5c90c2-...
...

Each line follows the format string you passed. The response contains at most 1000 lines (see amount).

Generating across many countries

Loop the request: one call per country, then concatenate:

import requests, urllib.parse

TEMPLATE = "eclipse_yourname-country-{cc}-session-{sid}-lifetime-30:YOUR_PASS:core.eclipseproxy.com:10000"
COUNTRIES = ["us", "gb", "de", "fr", "kh"]

all_proxies = []
for cc in COUNTRIES:
    proxy = urllib.parse.quote(TEMPLATE.format(cc=cc, sid=f"batch-{cc}"))
    r = requests.get(
        f"https://www.eclipseproxy.com/api/genProxy"
        f"?proxy={proxy}&format=h:pt:u:ps&amount=10"
    )
    all_proxies.extend(r.text.splitlines())

print(len(all_proxies), "proxies generated")

const countries = ["us", "gb", "de", "fr", "kh"];
const template = (cc, sid) =>
  `eclipse_yourname-country-${cc}-session-${sid}-lifetime-30:YOUR_PASS:core.eclipseproxy.com:10000`;

const all = [];
for (const cc of countries) {
  const proxy = encodeURIComponent(template(cc, `batch-${cc}`));
  const r = await fetch(
    `https://www.eclipseproxy.com/api/genProxy?proxy=${proxy}&format=h:pt:u:ps&amount=10`
  );
  all.push(...(await r.text()).split("\n"));
}
console.log(all.length, "proxies generated");

for cc in us gb de fr kh; do
  curl -s "https://www.eclipseproxy.com/api/genProxy\
?proxy=eclipse_yourname-country-$cc-session-batch-$cc-lifetime-30%3AYOUR_PASS%3Acore.eclipseproxy.com%3A10000\
&format=h:pt:u:ps&amount=10"
done

Rotating sessions on demand

To force a new IP on a sticky session, change the session- segment in the proxy template before regenerating. Same session ID returns the same IP; new session ID returns a new IP.

Use cases

Bulk generation: get 100 proxies at once for a scrape job
Format conversion: generate the same logical proxy in multiple formats for different tools
Per-session batching: append a random session ID, request amount=N, get N unique sticky sessions

Check remaining bandwidth Overview

Overview

Authentication

Account Endpoints

Reseller Endpoints

Generate proxies

Query parameters

Example request

Response format

Generating across many countries

Rotating sessions on demand

Use cases

​Query parameters

​Example request

​Response format

​Generating across many countries

​Rotating sessions on demand

​Use cases

Query parameters

Example request

Response format

Generating across many countries

Rotating sessions on demand

Use cases