Nessun KYC — nessun documento d'identità, nessun selfie, nessun documento · Targeting a livello di città su ogni piano · Pagamento in crypto
Lingua: Italiano
Inizia ora

Documentazione · HTTP, HTTPS, SOCKS5

Documentazione API proxy per città e gateway

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.

Ultimo aggiornamento: · 4 min di lettura

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.

Quali segmenti dello username posso usare?

Formato completo: USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}. Mantieni l'ordine; ometti ciò che non ti serve.

SegmentoEsempioSignificato
-country-<cc>-country-idCodice paese ISO a due lettere, minuscolo
-city-<name>-city-surabayaNome della città, minuscolo, con underscore al posto degli spazi
-asn-<number>-asn-7713Numero di rete ISP, senza "AS"
-session-<id>-session-cart2Associa le richieste a un unico IP sticky
-ttl-<minutes>-ttl-20Durata sticky, fino a 30 minuti

Quali host, porte e autenticazione uso?

Hostgw.banyanproxies.com
Porta HTTP / HTTPS7777
Porta SOCKS57778
AutenticazioneUsername 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
RotazioneOgni 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 stickyfino a 30 minuti (l'IP può cambiare prima)
BloccatoSiti bancari, governativi e portali di pagamento, più le porte SMTP (invio email) 25, 465 e 587

Quali esempi di codice posso copiare?

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 su SOCKS5: un IP di Wellington
curl --socks5-hostname gw.banyanproxies.com:7778 \
  -U "USERNAME-country-nz-city-wellington:PASSWORD" \
  https://ipinfo.io/json
Python (httpx): riprova con una nuova sessione quando un IP fallisce
import 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"))
Node.js (undici): un IP di Ho Chi Minh City
// 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));
Playwright (Python): un browser con un IP di Sydney e fuso orario corrispondente
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()

Cosa significano i codici di errore più comuni?

Codice o sintomoCausa probabileCosa fare
407 Proxy Authentication RequiredUsername, password o sintassi del segmento erratiCopia di nuovo le credenziali; controlla trattini e underscore
Timeout alla connessionePorta errata o un firewallUsa 7777 per HTTP, 7778 per SOCKS5
Errori solo per una cittàPochi dispositivi domestici online lì in questo momentoRiprova più tardi, usa una città vicina o rimuovi il segmento della città
403 o 429 dal targetIl target rifiuta o applica un rate limitRallenta; rispetta i termini del sito e robots.txt
Connessione rifiutata verso una porta bancaria o SMTPTarget bloccatoQuesti target sono bloccati da policy

Dove trovo il resto della documentazione?

Dove vado quando qualcosa fallisce?

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.

Cos'altro chiedono gli sviluppatori?

Serve un endpoint speciale per ogni paese o città?

No. Un unico gateway serve tutte le località; è il nome utente a decidere dove si trova l'IP.

Posso usare una allowlist di IP invece di una password?

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.

Gli esempi vengono testati?

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