Proxy API

Endpoint

# Username = your token + optional session/country qualifiers
# Password = blank

Grundlegende Verwendung

curl -x 'http://YOUR_TOKEN:@backconnect.crawlbase.com:9000' \
     'https://httpbin.org/ip'

import requests

proxies = {
    'http':  'http://YOUR_TOKEN:@backconnect.crawlbase.com:9000',
    'https': 'http://YOUR_TOKEN:@backconnect.crawlbase.com:9000',
}
res = requests.get('https://httpbin.org/ip', proxies=proxies)

Jeder Request läuft standardmäßig über eine andere Residential-IP: reine Rotation.

Sticky Sessions

Um Requests an eine einzelne IP zu binden, hängen Sie eine Session-ID an Ihren Username an. Dieselbe Session-ID liefert für ca. 30 Minuten dieselbe IP zurück.

# Format: TOKEN-session-SESSION_ID
curl -x 'http://YOUR_TOKEN-session-checkout42:@backconnect.crawlbase.com:9000' \
     'https://shop.example.com/cart'

Länder-Targeting

# Format: TOKEN-country-XX
curl -x 'http://YOUR_TOKEN-country-DE:@backconnect.crawlbase.com:9000' \
     'https://www.amazon.de'

# Combine: country + session
curl -x 'http://YOUR_TOKEN-country-DE-session-cart-1:@backconnect.crawlbase.com:9000' \
     'https://www.amazon.de/cart'

Username-Qualifier

Referenz aller verfügbaren Username-Modifier, kombiniert mit Bindestrichen.

Statische IPs und Geolokalisierung

Wenn Sie über mehrere Requests hinweg dieselbe Exit-IP behalten müssen (mehrstufige Checkout-Flows, Account-Login + Scrape, alles, was darauf basiert, dass die Zielseite denselben Client erkennt), kann Backconnect eine statische IP reservieren und Ihnen Port + Session-Lebensdauer zurückgeben. Der Proxy hält diese IP dann an Ihr Token gebunden, solange Sie sie innerhalb des Session-Fensters weiter nutzen.

Der Endpoint für statische IPs ist auf 1 Request pro 5 Minuten pro Land rate-limited (oder 1 pro 5 Minuten insgesamt, wenn kein Land angegeben wird). Cachen Sie den Port, den Ihr Client erhält: fordern Sie ihn nicht bei jedem Crawl erneut an.

Statische IP anfordern

Gibt einen Port zur Verwendung mit proxy.crawlbase.com zurück, zusammen mit den Sekunden, die die Bindung aktiv bleibt. Der Session-Timer verlängert sich automatisch, solange Sie weiter Traffic über diesen Port innerhalb des Fensters senden.

curl 'https://api.crawlbase.com/proxy/static?token=YOUR_TOKEN'

# Response
# { "port": 1234, "host": "proxy.crawlbase.com", "session_time": 10 }

Statische IP aus einem bestimmten Land

Übergeben Sie einen zweistelligen ISO-3166-Ländercode (US, GB, DE, IT, RU, …), um die statische IP an diese Region zu binden. Wenn im angeforderten Land aktuell kein Port frei ist, enthält die Response einen Fehler: warten Sie ab und versuchen Sie es unter Berücksichtigung des Country-Bucket-Rate-Limits erneut.

curl 'https://api.crawlbase.com/proxy/static?token=YOUR_TOKEN&country=FR'

# Response
# { "port": 4551, "host": "proxy.crawlbase.com", "session_time": 10 }

IP-Whitelisting

Backconnect unterstützt IP-Whitelisting: Lassen Sie die ausgehenden IPs Ihres Servers sich gegenüber dem Proxy authentifizieren, ohne bei jedem Request das Token zu senden. Nützlich für Pipelines mit fester IP, die keine Credentials im Code haben wollen, und der einzige Weg, Backconnect aus Umgebungen zu nutzen, die keinen Proxy-Authorization-Header übergeben können.

Drei Endpoints, alle unter /proxy/whitelist_ips, unterschieden durch die HTTP-Methode. Änderungen brauchen bis zu 1 Minute, um sich zu propagieren.

Whitelisted IP hinzufügen

curl -X POST 'https://api.crawlbase.com/proxy/whitelist_ips?token=YOUR_TOKEN&ip=123.123.123.123'

Whitelisted IP entfernen

curl -X DELETE 'https://api.crawlbase.com/proxy/whitelist_ips?token=YOUR_TOKEN&ip=123.123.123.123'

Whitelisted IPs anzeigen

Gibt die aktuelle Liste der Whitelisted IPs für Ihr Token im JSON-Format zurück.

curl 'https://api.crawlbase.com/proxy/whitelist_ips?token=YOUR_TOKEN'

Backconnect vs. Smart AI Proxy