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.