Dokumentation
Produkt-APIs und Monitore
Alle Endpunkte nutzen einen API-Schlüssel (Authorization: Bearer pxk_…) und werden pro erfolgreicher Anfrage bzw. Prüfung vom Guthaben abgerechnet – ohne zusätzliche GB-Abrechnung. Anfragen, die das Ziel nicht erreichen (kein Node verfügbar, Ziel gesperrt, interner Fehler), sind kostenlos. Jede Antwort enthält charged_micros (1 000 000 = 1 €). Aktuelle Preise: GET https://api.proxinity.one/v1/products/prices oder Preise.
Für alle Abrufe gelten dieselben Regeln wie für Proxys: nur Port 80/443, keine privaten Netze, gesperrte Kategorien, Limits je Zielseite.
Standort
Alle Einzel-APIs akzeptieren country (ISO-Code), city, asn, pool (residential oder datacenter) und session – wie die Abruf-API.
Render-API
POST https://api.proxinity.one/v1/render
{ "url": "https://example.com", "country": "DE", "wait_ms": 1500,
"width": 1366, "height": 900, "block_media": true }
→ { "status": 200, "final_url": "…", "title": "…", "html": "<html>…",
"redirects": [{ "url": "…", "status": 301 }], "elapsed_ms": 2100, "charged_micros": 3000 }Screenshot-API
POST https://api.proxinity.one/v1/screenshot (JSON mit "screenshot": base64-JPEG)
POST https://api.proxinity.one/v1/screenshot?output=image (Antwort direkt als image/jpeg)
{ "url": "https://example.com", "full_page": true, "html": false }Extract-API (Produktdaten)
POST https://api.proxinity.one/v1/extract
{ "url": "https://shop.example/p/1", "render": false, "text": false,
"selectors": { "preis": ".price", "lieferzeit": ".delivery" } }
→ { "status": 200, "data": { "title": "…", "description": "…", "canonical": "…",
"products": [{ "name", "sku", "gtin", "brand", "price", "currency", "availability", "url", "image", "rating", "review_count" }],
"jobs": [{ "title", "company", "location", "remote", "date_posted", "salary_min", "salary_max", "url", … }],
"listings": [{ "type", "name", "price", "currency", "address", "rooms", "floor_size", "url" }],
"items": [{ "name", "url" }], "rating": { "rating", "review_count" },
"open_graph": { … }, "selectors": { "preis": ["19,99 €"] } } }Geo-Check
POST https://api.proxinity.one/v1/geo-check
{ "url": "https://shop.example", "render": true, "screenshot": false,
"locations": [{ "country": "DE" }, { "country": "AT" }, { "country": "CH", "city": "zurich" }] }
→ { "results": [{ "location": "DE", "ok": true, "status": 200, "final_url": "…", "title": "…",
"redirects": [], "content_hash": "…", "language": "de", "currency": "EUR" }, …],
"summary": { "reachable": 3, "different_final_urls": false, "different_content": true } }Bis zu 10 Standorte; berechnet wird jeder Standort, der das Ziel erreicht hat.
Monitore
GET https://api.proxinity.one/v1/monitors
POST https://api.proxinity.one/v1/monitors
GET https://api.proxinity.one/v1/monitors/{id}
PATCH https://api.proxinity.one/v1/monitors/{id} (name, url, config, locations, interval_minutes, status: active|paused, alert_email)
DELETE https://api.proxinity.one/v1/monitors/{id} (löscht auch alle Ergebnisse)
POST https://api.proxinity.one/v1/monitors/{id}/run (sofort prüfen)
GET https://api.proxinity.one/v1/monitors/{id}/results?limit=200
GET https://api.proxinity.one/v1/monitors/{id}/items (Feeds)| kind | Mindestintervall | config |
|---|---|---|
uptime | 5 min | keyword, expect_status, max_ms |
price | 60 min | selector, render, alert_on (any|drop|rise), target_price |
rank | 12 h | domain, keywords (1–20), engine (bing|google), alert_delta |
adverify | 30 min | expected_domain |
change | 15 min | selector, render |
feed | 60 min | feed_type (auto|jobs|listings|products), item_selector, render |
Alle Typen akzeptieren zusätzlich webhook_url (HTTPS). Alarme werden als JSON gesendet: { "monitor_id", "name", "kind", "alerts": ["…"], "at" } mit Signatur im Header X-Proxinity-Signature. Webhooks laufen ebenfalls über das Proxinity-Netz; interne Adressen sind nicht erreichbar.
POST https://api.proxinity.one/v1/monitors
{ "name": "Konkurrenz Kaffeemaschine", "kind": "price", "url": "https://shop.example/p/1",
"config": { "alert_on": "drop", "target_price": 179 },
"locations": [{ "country": "DE" }, { "country": "AT" }], "interval_minutes": 360 }Feeds können ohne API-Schlüssel als RSS oder JSON unter einer geheimen Adresse abonniert werden (im Dashboard beim Monitor).
Sicherheits-Check
Nicht-invasiver externer Check (TLS, Header, Cookies, offene Dateien, CORS, Software-Versionen, SPF/DMARC) mit Note A–F und Empfehlung je Befund. Nur für Domains mit Eigentumsnachweis; der Nachweis wird vor jedem Scan erneut geprüft.
POST https://api.proxinity.one/v1/security/domains { "domain": "meinefirma.de" }
→ { "id": "…", "verification": { "dns_name": "_proxinity-verify.meinefirma.de", "dns_type": "TXT",
"dns_value": "proxinity-verify=…", "file_url": "https://meinefirma.de/.well-known/proxinity-verify.txt" } }
POST https://api.proxinity.one/v1/security/domains/{id}/verify
PATCH https://api.proxinity.one/v1/security/domains/{id} { "weekly_scan": true }
POST https://api.proxinity.one/v1/security/scans { "domain_id": "…", "host": "shop.meinefirma.de" } (Basis-Check)
POST https://api.proxinity.one/v1/security/scans { "domain_id": "…", "level": "pentest", "subdomains": true,
"ports": true, "server_confirmed": true,
"auth_headers": { "Cookie": "session=…" } } (Pentest)
POST https://api.proxinity.one/v1/security/scans { "domain_id": "…", "level": "pentest", "retest_of": "<scan-id>" } (kostenloser Nachtest)
PATCH https://api.proxinity.one/v1/security/domains/{id} { "weekly_scan": true, "weekly_level": "pentest", "server_confirmed": true }
GET https://api.proxinity.one/v1/security/scans/{id} → status, score, grade, findings[{ id, severity, title, detail, recommendation, evidence }]Der Basis-Check dauert etwa eine Minute und sendet rund 20 gewöhnliche Anfragen. Der Pentest (OWASP ZAP aktiver Scan, Nuclei, Subdomains aus Zertifikats-Logs, Dienste-Check nur mit server_confirmed und nicht für CDN/Shared Hosting) dauert 15–60 Minuten; Pentests laufen nacheinander in einer Warteschlange. Befunde enthalten zusätzlich source, url, cvss, cve und cwe. Berechnet wird nur bei Erfolg; höchstens 10 Scans pro Domain und Tag. Zugangsdaten für angemeldete Tests werden verschlüsselt und nach Beginn des Tests gelöscht.
Aufbewahrung
Monitor-Ergebnisse werden 90 Tage, Feed-Einträge 180 Tage nach dem letzten Auftreten gespeichert. HTML, Screenshots und Extraktionsergebnisse der Einzel-APIs werden nicht gespeichert.