Documentazione API
Account, ricariche, ordini, utilizzo e chiavi API su HTTPS.
Documentazione · HTTP, HTTPS, SOCKS5
Tutto ciò che ti serve per connetterti: un unico gateway, un unico formato di username e esempi testati che puoi incollare. L'API per account e ordini è documentata nella documentazione API.
Risposta rapida
Come mi connetto ai proxy residenziali di Banyan Proxies?
Connettiti a gw.banyanproxies.com, porta 7777 per HTTP e HTTPS oppure 7778 per SOCKS5, con la tua password del proxy e uno username composto da segmenti: USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15. Usa solo i segmenti che ti servono. Ogni piano, a partire da 1,88 USD per 1 GB, include il targeting per città e ASN.
Formato completo: USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}. Mantieni l'ordine; ometti ciò che non ti serve.
| Segmento | Esempio | Significato |
|---|---|---|
-country-<cc> | -country-id | Codice paese ISO a due lettere, minuscolo |
-city-<name> | -city-surabaya | Nome della città, minuscolo, con underscore al posto degli spazi |
-asn-<number> | -asn-7713 | Numero di rete ISP, senza "AS" |
-session-<id> | -session-cart2 | Associa le richieste a un unico IP sticky |
-ttl-<minutes> | -ttl-20 | Durata sticky, fino a 30 minuti |
| Host | gw.banyanproxies.com |
|---|---|
| Porta HTTP / HTTPS | 7777 |
| Porta SOCKS5 | 7778 |
| Autenticazione | Username e password su ogni piano, oppure una allowlist IP (fino a 10 IP). Sub-utenti con proprie credenziali e limite di traffico. Chiavi API revocabili in qualsiasi momento |
| Rotazione | Ogni nuova connessione riceve un IP dal pool, di solito diverso; per ottenere un nuovo IP a ogni richiesta, invia una richiesta per connessione (disattiva il keep-alive) |
| Sessioni sticky | fino a 30 minuti (l'IP può cambiare prima) |
| Bloccato | Siti bancari, governativi e portali di pagamento, più le porte SMTP (invio email) 25, 465 e 587 |
Ogni esempio richiede un IP e stampa ciò che vede un servizio di lookup. Sostituisci USERNAME e PASSWORD. La pagina di targeting per città e la guida alle sessioni sticky hanno ulteriori dettagli.
curl --socks5-hostname gw.banyanproxies.com:7778 \
-U "USERNAME-country-nz-city-wellington:PASSWORD" \
https://ipinfo.io/jsonimport uuid
import httpx
HOST = "gw.banyanproxies.com"
PORT = 7777
def fetch(url, city="lahore", country="pk", tries=3):
for _ in range(tries):
sid = uuid.uuid4().hex[:8]
user = f"USERNAME-country-{country}-city-{city}-session-{sid}-ttl-10"
proxy = f"http://{user}:PASSWORD@{HOST}:{PORT}"
try:
with httpx.Client(proxy=proxy, timeout=30) as client:
r = client.get(url)
r.raise_for_status()
return r.text
except httpx.HTTPError as exc:
print("retrying with a new IP:", exc)
return None
print(fetch("https://ipinfo.io/json"))// npm install undici
const { ProxyAgent, fetch } = require("undici");
const user = "USERNAME-country-vn-city-ho_chi_minh_city";
const token = "Basic " + Buffer.from(`${user}:PASSWORD`).toString("base64");
const dispatcher = new ProxyAgent({
uri: "http://gw.banyanproxies.com:7777",
token,
});
async function main() {
const res = await fetch("https://ipinfo.io/json", { dispatcher });
const info = await res.json();
console.log(info.ip, info.city, info.region);
}
main().catch((err) => console.error(err.message));from playwright.sync_api import sync_playwright
PROXY = {
"server": "http://gw.banyanproxies.com:7777",
"username": "USERNAME-country-au-city-sydney-session-syd1-ttl-15",
"password": "PASSWORD",
}
with sync_playwright() as p:
browser = p.chromium.launch(proxy=PROXY)
context = browser.new_context(
timezone_id="Australia/Sydney",
locale="en-AU",
)
page = context.new_page()
page.goto("https://ipinfo.io/json")
print(page.inner_text("body"))
browser.close()| Codice o sintomo | Causa probabile | Cosa fare |
|---|---|---|
| 407 Proxy Authentication Required | Username, password o sintassi del segmento errati | Copia di nuovo le credenziali; controlla trattini e underscore |
| Timeout alla connessione | Porta errata o un firewall | Usa 7777 per HTTP, 7778 per SOCKS5 |
| Errori solo per una città | Pochi dispositivi domestici online lì in questo momento | Riprova più tardi, usa una città vicina o rimuovi il segmento della città |
| 403 o 429 dal target | Il target rifiuta o applica un rate limit | Rallenta; rispetta i termini del sito e robots.txt |
| Connessione rifiutata verso una porta bancaria o SMTP | Target bloccato | Questi target sono bloccati da policy |
Account, ricariche, ordini, utilizzo e chiavi API su HTTPS.
Regole di ortografia ed esempi per ogni città.
Numeri di rete dei principali ISP domestici.
Dalla ricarica alla prima richiesta.
Controlla prima lo stato del servizio, poi il proxy city checker per dubbi sulla posizione e il glossario per i termini. Scrivi al supporto dalla pagina dei contatti.
No. Un unico gateway serve tutte le località; è il nome utente a decidere dove si trova l'IP.
Username e password su ogni piano, oppure una allowlist IP (fino a 10 IP). Sub-utenti con proprie credenziali e limite di traffico. Chiavi API revocabili in qualsiasi momento.
Ogni esempio Python viene compilato e ogni esempio JavaScript viene verificato sintatticamente prima della pubblicazione. Prima installa le librerie indicate: httpx, undici o Playwright.
1 GB 1,88 USD · targeting città · senza KYC
Inizia ora