Wie man LatamProxies Residential-Proxys einrichtet (2026)

Wie wird der Proxy-Benutzername aufgebaut?

Alle Zielvorgaben werden im Benutzernamen angegeben, sodass Sie nie einen anderen Host oder Port pro Land benötigen. Das vollständige Format ist USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}. Jeder Teil nach USERNAME ist optional.

• USERNAME allein: eine rotierende Residential-Proxys-IP aus jedem unterstützten Land.
• USERNAME-country-mx: eine rotierende Residential-Proxys-IP in Mexiko.
• USERNAME-country-ar-city-buenos_aires: eine rotierende Residential-Proxys-IP in Buenos Aires.
• USERNAME-country-br-session-abc123-ttl-30: dieselbe brasilianische IP für bis zu 30 Minuten.

Ländercodes sind zwei Buchstaben lange ISO-Codes in Kleinbuchstaben. Stadtnamen sind klein geschrieben mit _ statt Leerzeichen und ohne Akzente: sao_paulo, nicht São Paulo. Fügen Sie keine anderen Parameter hinzu: das Gateway liest keine ASN-, ZIP- oder Carrier-Parameter im Benutzernamen.

Wie teste ich den Residential Proxy mit cURL?

cURL ist der schnellste Weg, um zu prüfen, ob Ihre Zugangsdaten und Zielvorgaben funktionieren. Die folgende Anfrage läuft über das HTTP-Gateway und gibt die Exit-IP aus. Ersetzen Sie USERNAME und PASSWORD durch die Werte aus Ihrem Dashboard.

curl -x http://gw.latamproxies.com:7777 \
  -U "USERNAME-country-br:PASSWORD" \
  https://api.ipify.org?format=json

curl --socks5-hostname gw.latamproxies.com:7778 \
  -U "USERNAME-country-mx-city-mexico_city-session-abc123-ttl-30:PASSWORD" \
  https://api.ipify.org?format=json

Wie verwende ich den Residential Proxy mit Python requests?

Mit requests setzen Sie dieselbe Proxy-URL für http und https. HTTPS-Ziele werden über das HTTP-Gateway mit CONNECT getunnelt, daher bleibt das URL-Schema des Proxys http://. Für SOCKS5 installieren Sie requests[socks] und verwenden socks5h://, damit DNS über den Proxy im Ziel-Land aufgelöst wird.

import requests

USER = "USERNAME-country-co"
PASS = "PASSWORD"
proxy = f"http://{USER}:{PASS}@gw.latamproxies.com:7777"

proxies = {"http": proxy, "https": proxy}
r = requests.get("https://api.ipify.org?format=json", proxies=proxies, timeout=30)
print(r.json())

# pip install "requests[socks]"
import requests

USER = "USERNAME-country-br-city-sao_paulo-session-job42-ttl-30"
PASS = "PASSWORD"
proxy = f"socks5h://{USER}:{PASS}@gw.latamproxies.com:7778"

with requests.Session() as s:
    s.proxies = {"http": proxy, "https": proxy}
    for _ in range(3):
        print(s.get("https://api.ipify.org?format=json", timeout=30).json())  # same IP 3 times

Wie verwende ich Residential-Proxys mit Node.js?

In Node.js 18 oder neuer liest das eingebaute fetch keine Proxy-Einstellungen, daher verwenden Sie undici's ProxyAgent und übergeben es als dispatcher. Bei Verwendung von axios nutzen Sie https-proxy-agent und setzen proxy: false, damit axios keine eigene Proxy-Logik anwendet.

// npm install undici
import { fetch, ProxyAgent } from 'undici';

const user = 'USERNAME-country-ar';
const pass = 'PASSWORD';
const dispatcher = new ProxyAgent({
  uri: 'http://gw.latamproxies.com:7777',
  token: 'Basic ' + Buffer.from(`${user}:${pass}`).toString('base64'),
});

const res = await fetch('https://api.ipify.org?format=json', { dispatcher });
console.log(await res.json());

// npm install axios https-proxy-agent
import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';

const user = encodeURIComponent('USERNAME-country-cl');
const pass = encodeURIComponent('PASSWORD');
const agent = new HttpsProxyAgent(`http://${user}:${pass}@gw.latamproxies.com:7777`);

const { data } = await axios.get('https://api.ipify.org?format=json', {
  httpsAgent: agent,
  proxy: false,
  timeout: 30000,
});
console.log(data);

Wie verwende ich Residential-Proxys mit Playwright?

Playwright akzeptiert den Proxy-Server, Benutzernamen und Passwort beim Start. Verwenden Sie eine Sticky-Session für die Browserarbeit: Eine Seite lädt viele Ressourcen, und eine IP pro Seite hält die Sitzung konsistent. Ändern Sie die Sitzungs-ID, um eine neue IP für den nächsten Browser-Kontext zu erhalten.

// npm install playwright
import { chromium } from 'playwright';

const browser = await chromium.launch({
  proxy: {
    server: 'http://gw.latamproxies.com:7777',
    username: 'USERNAME-country-pe-city-lima-session-pw1-ttl-30',
    password: 'PASSWORD',
  },
});
const page = await browser.newPage();
await page.goto('https://api.ipify.org?format=json');
console.log(await page.textContent('body'));
await browser.close();

# pip install playwright && playwright install chromium
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gw.latamproxies.com:7777",
        "username": "USERNAME-country-br-session-pw2-ttl-30",
        "password": "PASSWORD",
    })
    page = browser.new_page()
    page.goto("https://api.ipify.org?format=json")
    print(page.text_content("body"))
    browser.close()

Wie nutze ich Residential-Proxys mit Puppeteer?

Chrome akzeptiert keine Zugangsdaten innerhalb von --proxy-server, daher übergibt Puppeteer den Server als Startargument und den Benutzernamen sowie das Passwort mit page.authenticate().

// npm install puppeteer
import puppeteer from 'puppeteer';

const browser = await puppeteer.launch({
  args: ['--proxy-server=http://gw.latamproxies.com:7777'],
});
const page = await browser.newPage();
await page.authenticate({
  username: 'USERNAME-country-mx-city-mexico_city-session-pp1-ttl-30',
  password: 'PASSWORD',
});
await page.goto('https://api.ipify.org?format=json');
console.log(await page.evaluate(() => document.body.innerText));
await browser.close();

Soll ich rotierende oder feste Sessions verwenden?

Verwenden Sie rotierende IPs für unabhängige Anfragen und Sticky Sessions für mehrstufige Abläufe. Neue IP bei jeder Anfrage oder Sticky Sessions bis zu 30 Minuten.

• Rotierend (kein session): ideal zum Crawlen vieler Produktseiten, wie zum Beispiel Mercado Libre Preisüberwachung, oder zum Abrufen von Suchergebnissen aus vielen Regionen.
• Sticky (-session-ID-ttl-30): optimal für Browser-Automatisierung, Paginierung, die von Cookies abhängt, Checkout-Flow-Tests im eigenen Shop und Werbeüberprüfungs-Abläufe.

Bei 4G/5G dedizierten Ports funktioniert die Rotation anders: die IP wird über einen API-Link gewechselt. Siehe die Anleitung zur Rotation mobiler Proxys.

Was bedeuten häufige Fehler?

Die meisten Probleme entstehen durch den Benutzernamen oder die Zielseite:

• 407 Proxy Authentication Required: Benutzername oder Passwort ist falsch. Prüfen Sie auf Leerzeichen und URL-kodieren Sie Sonderzeichen im Passwort.
• Verbindung abgelehnt oder Timeout beim Verbinden: Überprüfen Sie Host und Port. HTTP nutzt 7777, SOCKS5 nutzt 7778.
• Falsches Land: Prüfen Sie den Ländercode (br, nicht bra) und die Schreibweise der Stadt (sao_paulo).
• 403 oder CAPTCHA vom Ziel: Verlangsamen Sie die Anfragen, rotieren Sie öfter oder verwenden Sie eine Sticky Session mit einem echten Browser.
• Ziel vom Gateway abgelehnt: Banken, Regierungsportale, Zahlungsportale und SMTP sind durch unsere Acceptable Use Policy blockiert.

Wenn das Problem weiterhin besteht, senden Sie eine E-Mail an [email protected] mit Ihrem Benutzernamen (ohne Passwort), dem Ziel und dem Fehler.