Zonder KYC — geen ID, geen selfie, geen documenten · Targeting op stadsniveau bij elk plan · Betaald in crypto
Taal: Nederlands
Aan de slag

Docs · HTTP, HTTPS, SOCKS5

Documentatie voor city proxy API en gateway

Alles wat je nodig hebt om verbinding te maken: één gateway, één gebruikersnaamformaat en geteste voorbeelden die je kunt plakken. De account- en order-API staat gedocumenteerd onder API docs.

Laatst bijgewerkt: · 4 min leestijd

Snel antwoord

Hoe maak ik verbinding met de residentiële proxy's van Banyan Proxies?

Maak verbinding met gw.banyanproxies.com, poort 7777 voor HTTP en HTTPS of 7778 voor SOCKS5, met je proxywachtwoord en een gebruikersnaam opgebouwd uit segmenten: USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15. Gebruik alleen de segmenten die je nodig hebt. Elk plan, vanaf US$ 1,88 voor 1 GB, bevat targeting op stad en ASN.

Welke gebruikersnaamsegmenten kan ik gebruiken?

Volledig formaat: USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}. Houd de volgorde aan; laat weg wat je niet nodig hebt.

SegmentVoorbeeldBetekenis
-country-<cc>-country-idTweeletterige ISO-landcode, kleine letters
-city-<name>-city-surabayaStadsnaam, kleine letters, underscores voor spaties
-asn-<number>-asn-7713ISP-netwerknummer, zonder "AS"
-session-<id>-session-cart2Koppelt verzoeken aan één sticky IP
-ttl-<minutes>-ttl-20Sticky-duur, tot 30 minuten

Welke host, poorten en authenticatie gebruik ik?

Hostgw.banyanproxies.com
HTTP / HTTPS-poort7777
SOCKS5-poort7778
AuthenticatieGebruikersnaam en wachtwoord bij elk plan, of een IP-allowlist (tot 10 IP's). Subgebruikers met eigen inloggegevens en verkeerslimiet. API-sleutels die je op elk moment kunt intrekken
RotatieElke nieuwe verbinding krijgt een IP uit de pool, meestal een ander; om bij elk verzoek een nieuw IP te krijgen, stuur je één verzoek per verbinding (zet keep-alive uit)
Sticky sessiestot 30 minuten (het IP kan eerder wisselen)
GeblokkeerdBank-, overheids- en betaalportaalsites, plus SMTP-poorten (voor e-mailverzending) 25, 465 en 587

Welke codevoorbeelden kan ik kopiëren?

Elk voorbeeld vraagt één IP aan en toont wat een lookup-service ziet. Vervang USERNAME en PASSWORD. De pagina voor stadsgerichte targeting en de handleiding voor sticky sessies bevatten meer.

curl via SOCKS5: een IP uit Wellington
curl --socks5-hostname gw.banyanproxies.com:7778 \
  -U "USERNAME-country-nz-city-wellington:PASSWORD" \
  https://ipinfo.io/json
Python (httpx): opnieuw proberen met een nieuwe sessie wanneer een IP faalt
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): één IP uit Ho Chi Minhstad
// 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): een browser met een IP uit Sydney en bijpassende tijdzone
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()

Wat betekenen veelvoorkomende foutcodes?

Code of symptoomWaarschijnlijke oorzaakWat te doen
407 Proxy Authentication RequiredVerkeerde gebruikersnaam, wachtwoord of segment-syntaxisKopieer de inloggegevens opnieuw; controleer koppeltekens en underscores
Timeout bij verbindenVerkeerde poort of een firewallGebruik 7777 voor HTTP, 7778 voor SOCKS5
Fouten bij slechts één stadDaar zijn nu weinig thuisapparaten onlineProbeer later opnieuw, gebruik een nabijgelegen stad of laat het stadssegment weg
403 of 429 van het doelwitHet doelwit weigert of beperkt het aantal verzoekenVertraag; respecteer de voorwaarden en robots.txt van de site
Verbinding geweigerd naar een bank- of SMTP-poortGeblokkeerd doelwitDeze doelwitten zijn geblokkeerd door beleid

Waar vind ik de rest van de documentatie?

Waar ga ik naartoe als iets mislukt?

Controleer eerst de servicestatus, dan de proxy-stadschecker bij twijfel over de locatie en de woordenlijst voor termen. Neem contact op met support via de contactpagina.

Wat vragen ontwikkelaars nog meer?

Heb ik een speciaal endpoint per land of stad nodig?

Nee. Eén gateway bedient elke locatie; de gebruikersnaam bepaalt waar het IP vandaan komt.

Kan ik een IP-allowlist gebruiken in plaats van een wachtwoord?

Gebruikersnaam en wachtwoord bij elk plan, of een IP-allowlist (tot 10 IP's). Subgebruikers met eigen inloggegevens en verkeerslimiet. API-sleutels die je op elk moment kunt intrekken.

Worden de voorbeelden getest?

Elk Python-voorbeeld wordt gecompileerd en elk JavaScript-voorbeeld wordt op syntax gecontroleerd voordat het wordt gepubliceerd. Installeer eerst de genoemde libraries: httpx, undici of Playwright.

1 GB US$ 1,88 · city-targeting · zonder KYC

Aan de slag