CrawlRelay Proxy-Dokumentation: Schnellstart

Wie sende ich meine erste Anfrage?

Kopiere den Benutzernamen und das Passwort aus deinem Dashboard und führe dann einen dieser Befehle aus. Jeder gibt die IP-Adresse zurück, die die Webseite sieht, welche sich normalerweise von Lauf zu Lauf ändert.

curl -x http://USERNAME-country-us:[email protected]:7777 https://api.ipify.org

import requests

proxy = "http://USERNAME-country-us:[email protected]:7777"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.text)

import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:[email protected]:7777");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());

Wie baue ich den Benutzernamen zusammen?

Beginne mit dem Benutzernamen aus deinem Dashboard und füge Parameter mit Bindestrichen hinzu, in der Reihenfolge des obigen Formats. Jeder Parameter ist optional. Werte sind klein geschrieben, und Städtenamen verwenden Unterstriche (new_york, sao_paulo). Die Verfügbarkeit der Städte variiert.

Wie verhalten sich rotierende und sticky Sessions?

Ein Benutzername ohne session- erhält bei jeder neuen TCP-Verbindung eine IP aus dem Pool, normalerweise eine andere. Ein Benutzername mit session-<id>-ttl-<minutes> behält dieselbe Exit-IP für diese ID, bis die TTL endet oder das Residential-Gerät offline geht.

• Rotation erfolgt pro Verbindung, nicht pro Anfrage: keep-alive verwendet denselben Exit.
• Nutze für jeden Job, jeden Browserkontext oder jeden Account-Flow eine neue Session-ID.
• Zwei Scraper, die dieselbe Session-ID verwenden, teilen sich eine Exit-IP.

Der Sessions-Guide behandelt die Wiederverwendung von Verbindungen in jeder Bibliothek.

Was sind die Limits?

• Blockierte Zieladressen: Banking-, Regierungs- und Zahlungsportal-Seiten sowie SMTP (E-Mail-Versand) Ports 25, 465 und 587. Anfragen zu ihnen werden verweigert.
• Nutzung: nur öffentliche Daten, gemäß der Acceptable Use Policy. Kein Account-Diebstahl, Betrug, Spam oder Versuche, absichtliche Blocks zu umgehen.
• Traffic: pro GB abgerechnet. Nutzung zählt alle über den Proxy gesendeten und empfangenen Daten (Upload und Download, Header inklusive). 1 GB = 1.000.000.000 Bytes. Verbindungsversuche, die fehlschlagen, bevor sie das Ziel erreichen, werden nicht gezählt.. Anfragen stoppen, wenn das Traffic-Kontingent eines Plans erschöpft ist.
• Sessions: bis zu 30 Minuten; die IP kann sich früher ändern, z. B. wenn das Residential-Proxys Gerät offline geht.
• Protokolle: HTTP, HTTPS (CONNECT) und SOCKS5.
• Gleichzeitigkeit: wird nicht berechnet. Das Limit ist, was jedes Ziel akzeptiert; siehe den Gleichzeitigkeitsleitfaden.

Wie verwalte ich Anmeldedaten und Nutzung?

Im Dashboard oder über die REST API unter https://crawlrelay.com/api/v1 mit einem API-Schlüssel. API-Schlüssel, die Sie jederzeit widerrufen können. Die Hauptaufgaben:

• Sub-User: je ein Satz Anmeldedaten pro Scraper oder Kundenprojekt, mit optionalem Traffic-Limit. Siehe residential API.
• IP-Allowlist: bis zu 10 IPs, die ohne Passwort verbinden können.
• Nutzung: tägliches Traffic-Limit pro Abo, um vor Erschöpfung zu warnen.
• Katalog: Länder, Städte, Bundesstaaten und ASNs, die Sie ansteuern können, damit Ihr Code vor der Nutzung einen Benutzernamen validieren kann.
• Bestellungen: weiteres Traffic-Guthaben vom Kontostand kaufen, ohne das Dashboard zu öffnen. Siehe Bestell-API.