Preisdaten-API — Zugriff auf Überwachungsdaten aus Ihren eigenen Systemen
Mit der REST-API von 4pricing.net kann Ihr technisches Team die Daten der Preisüberwachung in eigene Systeme übernehmen (zum Beispiel ERP, WMS oder Onlineshop). 4pricing bietet keine fertigen Konnektoren: Die Anbindung baut Ihr Entwickler auf der API auf. Die Authentifizierung erfolgt über einen API-Key, die Antworten sind standardisiertes JSON, und die Spezifikation ist als OpenAPI 3.0 veröffentlicht und direkt in Ihren Client importierbar.
Wichtigste Endpunkte
Die API liefert die Überwachungsdaten auf Ebene des verfolgten Produkts: die Produktliste mit aktuellem Preis, die Preishistorie eines Produkts und eine Sammel-Minihistorie für Listenansichten. Produkte werden über die product_id identifiziert, die beim Anlegen zurückgegeben wird — sie ist der Routenschlüssel. Beträge kommen in kleinster Währungseinheit, in den Feldern current_price_cents und price_cents, zusammen mit der Währung, und jeder Datensatz trägt den exakten Prüfzeitpunkt (last_scraped_at bzw. scraped_at).
- GET /products/ — Ihre überwachten Produkte, mit aktuellem Preis und Währung
- GET /products/{product_id}/history — die Preishistorie eines Produkts, mit Zeitstempeln
- GET /products/sparklines — Sammel-Minihistorie, eine Preisreihe je Produkt
- POST /alerts/ — Alarm anlegen (Schwelle, prozentualer Rückgang, Lagerbestand, Wettbewerber)
Authentifizierung und Ratenbegrenzung
Die Authentifizierung erfolgt über den Header X-API-Key oder gleichwertig über Authorization: Bearer mit demselben Schlüssel. Schlüssel werden im Panel unter „API & Schlüssel“ erzeugt; der vollständige Wert wird nur einmal angezeigt, beim Anlegen. Die Ratenbegrenzung liegt bei 60 Anfragen pro Minute und Konto, geteilt von allen Ihren Schlüsseln; darüber antwortet die API mit 429 und sendet den Header Retry-After.
Vorteile und Grenzen
Vorteile
- Ihr Team kann das eigene ERP/WMS direkt aus der API speisen, ohne manuellen CSV-Export (den Konnektor bauen Sie selbst)
- Alarme per Webhook — Sie müssen nicht pollen
- Veröffentlichte OpenAPI-3.0-Spezifikation, direkt in Ihren Client importierbar
- Zugriff auf den empfohlenen Preis der Vergleichsgruppe, nicht nur auf Rohdaten
Grenzen
- Die Grenze von 60 Anfragen/Minute je Konto (geteilt von allen Schlüsseln) verlangt bei großen Sortimenten Sammelabfragen und lokales Caching
- Der Webhook setzt eine öffentliche http/https-URL (Port 80/443) in Ihrer Infrastruktur voraus
Kurzes Fazit
Die API deckt das Lesen der Überwachungsdaten und des empfohlenen Preises, das Übermitteln eigener Preise und das Übernehmen des empfohlenen Preises ab, kommt aber ohne Konnektoren für ERP oder Shop. Große Sortimente profitieren von Sammelabfragen (Paginierung, Sammel-Minihistorie) und lokalem Caching.
Spezifikationstabelle
| Endpunkt | Methode | Antwort |
|---|---|---|
| /products/ | GET | JSON-Array der überwachten Produkte, mit current_price_cents |
| /products/{product_id}/history | GET | JSON-Array der Historie, mit Zeitstempeln |
| /products/sparklines | GET | JSON mit einer Preisreihe je Produkt |
| /alerts/ | POST | Der angelegte Alarm, mit Typ und Schwelle |
API vs. CSV-Export auf Abruf
| Kriterium | REST-API | CSV-Export |
|---|---|---|
| Datenaktualität | Die Daten sind so alt wie die letzte Prüfung | Stand zum Zeitpunkt des Downloads |
| Anbindung an das ERP | Über HTTP, mit einem Konnektor, den Ihr Team schreibt | Import manuell/per Cron |
| Push-Alarme | Ja (Webhook) | Nein |
Häufige Fragen
Wie erhalte ich einen API-Key?
Sie erzeugen den Schlüssel im Panel Ihres 4pricing.net-Kontos im Bereich „API & Schlüssel“. Der vollständige Wert wird nur einmal beim Anlegen angezeigt — geht er verloren, widerrufen Sie den Schlüssel und erzeugen einen neuen.
Kann ich die Daten aller Produkte auf einmal abrufen?
Ja, mit GET /products/?skip=0&limit=200 blättern Sie durch das gesamte überwachte Sortiment; die Gesamtzahl der Zeilen steht im Header X-Total-Count. Für lange Listen liefert GET /products/sparklines die Minihistorie mehrerer Produkte in einem Aufruf. Für große Sortimente empfehlen wir eine nächtliche Synchronisation und häufigere Abfragen nur für die wichtigen Produkte.
In welchem Format liefert die API die Preishistorie?
Als JSON-Array von Objekten {product_id, price_cents, currency, in_stock, scraped_at}, absteigend nach Datum sortiert. Der Preis kommt in kleinster Währungseinheit (price_cents), nicht in ganzen Währungseinheiten, und scraped_at ist ein exakter ISO-8601-Zeitstempel.
Welche Ereignisse sendet der Webhook?
Es gibt eine Webhook-URL je Konto, und sie empfängt jeden Alarmtyp, den Sie anlegen: Preis unter einer Schwelle, Preis über einer Schwelle, prozentualer Rückgang, wieder auf Lager, ein Wettbewerber unterbietet Sie und Verlust der Position als günstigster Anbieter. Einen Alarm auf die Kostenuntergrenze als solche gibt es nicht.