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)
kindMindestintervallconfig
uptime5 minkeyword, expect_status, max_ms
price60 minselector, render, alert_on (any|drop|rise), target_price
rank12 hdomain, keywords (1–20), engine (bing|google), alert_delta
adverify30 minexpected_domain
change15 minselector, render
feed60 minfeed_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.