Product Data API · v1
Produkt- & Preisdaten per EAN und ASIN
Eine kommerzielle REST-API: Sende eine EAN/GTIN oder ASIN und erhalte das Produkt samt aktueller Preise aller Shops, Preis-Statistiken und Verfügbarkeit. Ideal für Vergleichsseiten, Apps, Repricing und KI-Agenten.
Für KI-Agenten & LLMs: Maschinenlesbare Spezifikation unter /api/v1/openapi.json (OpenAPI 3.1) und eine Übersicht unter /llms.txt. Auth: Header x-api-key. Kern-Endpoint: GET /api/v1/lookup?ean=|asin=.
Pläne
Jede authentifizierte Anfrage zählt gegen dein monatliches Kontingent. Bei Überschreitung antwortet die API mit 402.
Authentifizierung
Sende deinen Key im Header x-api-key. Jede Antwort enthält X-Plan, X-Quota-Limit und X-Quota-Remaining.
Lookup per EAN / ASIN
Der Kern-Endpoint — Preisdaten zu einem Identifier.
Anfrage
curl -H "x-api-key: YOUR_KEY" \ "https://api.preisnest.de/api/v1/lookup?ean=4006381333931"
Antwort
{
"data": {
"identifier": { "ean": "4006381333931", "asin": "B0...", "mpn": "..." },
"product": { "name": "...", "brand": "...", "url": "..." },
"priceStats": { "currency": "EUR", "min": 1299.0, "max": 1499.0,
"lowestEver": 1249.0, "offerCount": 6 },
"offers": [
{ "merchant": "MediaMarkt", "totalPrice": 1299.0,
"availability": "in_stock", "url": ".../go/123" }
]
}
}Endpunkte
| Methode | Pfad | Beschreibung | Auth |
|---|---|---|---|
| GET | /api/v1/lookup?ean= | asin= | ★ Produkt + alle Shop-Preise per EAN/GTIN oder ASIN | API-Key |
| GET | /api/v1/products?q=&category=&brand=&sort= | Produkte suchen & filtern | API-Key |
| GET | /api/v1/products/{slug} | Produktdetail inkl. Angebote | API-Key |
| GET | /api/v1/products/{id}/offers | Alle Angebote eines Produkts | API-Key |
| GET | /api/v1/products/{id}/price-history?days=90 | Preisverlauf | API-Key |
| GET | /api/v1/categories · /brands · /merchants | Stammdaten | API-Key |
| GET | /api/v1/articles | Ratgeber-Artikel | API-Key |
| GET | /api/v1/plans · /openapi.json | Pläne & OpenAPI-Spec (öffentlich) | öffentlich |
Statuscodes
| 401 | Kein oder ungültiger API-Key (Header x-api-key). |
| 402 | Monatliches Kontingent erschöpft — Plan upgraden. |
| 404 | Kein Produkt für diese EAN/ASIN gefunden. |
| 429 | Rate-Limit überschritten (Anfragen pro Minute). |
Häufige Fragen
- Wie bekomme ich Produktpreise per EAN oder ASIN?
- Sende GET /api/v1/lookup?ean=<EAN> oder ?asin=<ASIN> mit deinem API-Key im Header x-api-key. Die Antwort enthält das Produkt, Preis-Statistiken und alle Shop-Angebote mit Gesamtpreis.
- Was kostet die Preisnest Product Data API?
- Es gibt einen kostenlosen Free-Plan mit 100 Anfragen/Monat sowie Starter (29 €, 10.000), Pro (99 €, 100.000) und Enterprise (unbegrenzt, auf Anfrage).
- Wie wird die Nutzung abgerechnet?
- Jede authentifizierte Anfrage zählt gegen das monatliche Kontingent deines Plans. Der Zähler wird zu Beginn jedes Kalendermonats zurückgesetzt. Bei Überschreitung antwortet die API mit HTTP 402.
- Gibt es eine maschinenlesbare Spezifikation?
- Ja, eine OpenAPI-3.1-Spec unter /api/v1/openapi.json und eine LLM-freundliche Übersicht unter /llms.txt.