Dokumentation
Abruf-API
Sie senden eine URL, Proxinity ruft sie über eine Residential-Node (oder den Rechenzentrums-Pool) ab und liefert Status, Header und Inhalt zurück. Keine Proxy-Konfiguration nötig – ideal für Skripte, No-Code-Tools und Serverless-Funktionen. Abgerechnet wird wie beim Proxy pro übertragenem GB; alle Zielregeln und Sperren gelten genauso.
Anfrage
POST https://api.proxinity.one/v1/fetch
Authorization: Bearer pxk_… (API-Schlüssel aus dem Dashboard)
Content-Type: application/json
{
"url": "https://example.com/produkte?seite=2",
"method": "GET", // GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS
"headers": { "Accept": "text/html" }, // optional
"body": "", // optional, mit "body_base64": true für Binärdaten
"country": "de", // optional
"city": "berlin", // optional
"asn": 3320, // optional, Internetanbieter
"pool": "residential", // oder "datacenter"
"session": "warenkorb42", // optional: gleiche IP für mehrere Anfragen
"timeout_ms": 30000, // 1000–60000
"follow_redirects": true
}Antwort
{
"status": 200,
"headers": { "Content-Type": "text/html; charset=utf-8", … },
"body": "<!doctype html>…",
"body_encoding": "text", // oder "base64" für Binärdaten
"final_url": "https://example.com/produkte?seite=2",
"elapsed_ms": 812,
"size": 48213,
"truncated": false // Antworten über 10 MB werden gekürzt
}Beispiele
curl -s https://api.proxinity.one/v1/fetch -H "Authorization: Bearer $PROXINITY_KEY" \
-H "Content-Type: application/json" -d '{"url":"https://api.ipify.org?format=json","country":"de"}'import requests
r = requests.post("https://api.proxinity.one/v1/fetch", headers={"Authorization": f"Bearer {KEY}"},
json={"url": "https://example.com", "country": "de"}, timeout=70)
print(r.json()["status"], r.json()["body"][:200])Fehler
402– Guthaben aufgebraucht.403 fetch_forbidden– Ziel gesperrt (private Netze, Router, gesperrte Kategorie, Port außer 80/443).503 fetch_nonode– keine Node für Pool/Land/Stadt/Provider verfügbar.502 fetch_failed– Ziel nicht erreichbar oder Zeitüberschreitung.
JavaScript wird nicht ausgeführt (kein Browser). Schutzmechanismen Dritter (CAPTCHAs, Logins) werden nicht umgangen.