{"openapi":"3.1.0","info":{"title":"BestenVergleich Preis-API","version":"1.0.0","description":"Öffentliche, kostenlose Preisvergleichs-API von bestenvergleich.de: 90.000+ Produkte, 200.000+ Angebote aus 6.000+ Shops, Preisverlauf, Testberichte aus Fachmagazinen. Rate-Limit 120 Anfragen/Minute je IP. Shop-Links sind Affiliate-Links. Für KI-Assistenten steht zusätzlich ein MCP-Server unter https://bestenvergleich.de/mcp bereit.","contact":{"name":"BestenVergleich GmbH","url":"https://bestenvergleich.de/kontakt","email":"info@bestenvergleich.de"}},"servers":[{"url":"https://bestenvergleich.de/api/v1"}],"paths":{"/search":{"get":{"operationId":"searchProducts","summary":"Produkte suchen","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2},"description":"Suchbegriff, z. B. Produktname oder Hersteller + Modell"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":25,"default":10}}],"responses":{"200":{"description":"Treffer mit Bestpreis","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"url":{"type":"string","format":"uri","description":"Produktseite mit Preisvergleich"},"image":{"type":["string","null"],"format":"uri"},"category":{"type":["object","null"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"}}},"manufacturer":{"type":["object","null"],"properties":{"id":{"type":"integer"},"name":{"type":"string"}}},"ean":{"type":["string","null"]},"price_min":{"type":["number","null"],"description":"Günstigster Preis in EUR inkl. MwSt."},"offer_count":{"type":"integer"},"bv_score":{"type":["integer","null"],"description":"BestenVergleich-Score 0–100 (Tests, Preis-Leistung, Beliebtheit)"},"rating":{"type":["number","null"],"description":"Testnote 0–100 aus Fachmagazinen"},"test_count":{"type":"integer"},"is_discount":{"type":"boolean"},"discount_pct":{"type":["integer","null"]},"price_old":{"type":["number","null"]}}}},"disclosure":{"type":"string"}}}}}}}}},"/products/{ref}":{"get":{"operationId":"getProduct","summary":"Produktdetails mit allen Angeboten, Preisverlauf, Tests und Attributen","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string"},"description":"Produkt-ID, EAN (8–14 Ziffern) oder Slug in der Form kategorie/produkt-slug"}],"responses":{"200":{"description":"Produkt","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"url":{"type":"string","format":"uri","description":"Produktseite mit Preisvergleich"},"image":{"type":["string","null"],"format":"uri"},"category":{"type":["object","null"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"}}},"manufacturer":{"type":["object","null"],"properties":{"id":{"type":"integer"},"name":{"type":"string"}}},"ean":{"type":["string","null"]},"price_min":{"type":["number","null"],"description":"Günstigster Preis in EUR inkl. MwSt."},"offer_count":{"type":"integer"},"bv_score":{"type":["integer","null"],"description":"BestenVergleich-Score 0–100 (Tests, Preis-Leistung, Beliebtheit)"},"rating":{"type":["number","null"],"description":"Testnote 0–100 aus Fachmagazinen"},"test_count":{"type":"integer"},"is_discount":{"type":"boolean"},"discount_pct":{"type":["integer","null"]},"price_old":{"type":["number","null"]}}},{"type":"object","properties":{"description":{"type":["string","null"]},"pros":{"type":["string","null"]},"cons":{"type":["string","null"]},"price_uvp":{"type":["number","null"]},"offers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"shop":{"type":"string"},"price":{"type":"number"},"shipping":{"type":"number"},"total":{"type":"number"},"availability":{"type":["string","null"]},"condition":{"type":["string","null"]},"source":{"type":"string","enum":["solute","ebay","awin","amazon"]},"url":{"type":"string","format":"uri","description":"Weiterleitung zum Shop (Affiliate-Link)"}}}},"used_offers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"shop":{"type":"string"},"price":{"type":"number"},"shipping":{"type":"number"},"total":{"type":"number"},"availability":{"type":["string","null"]},"condition":{"type":["string","null"]},"source":{"type":"string","enum":["solute","ebay","awin","amazon"]},"url":{"type":"string","format":"uri","description":"Weiterleitung zum Shop (Affiliate-Link)"}}}},"price_history":{"type":["object","null"],"properties":{"data_points":{"type":"integer"},"first_date":{"type":"string","format":"date"},"last_date":{"type":"string","format":"date"},"min_90d":{"type":"number"},"max_90d":{"type":"number"},"median_30d":{"type":["number","null"]},"points":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"price":{"type":"number"}}}}}},"tests":{"type":"array","items":{"type":"object","properties":{"magazine":{"type":["string","null"]},"rating":{"type":["string","null"]},"rating_value":{"type":["number","null"]},"verdict":{"type":["string","null"]},"date":{"type":["string","null"]}}}},"attributes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"price_alert_url":{"type":"string"},"disclosure":{"type":"string"}}}]}}}},"404":{"description":"Produkt nicht gefunden"}}}},"/price-drops":{"get":{"operationId":"getPriceDrops","summary":"Aktuelle Preisrückgänge (Deals) gegenüber dem historischen Durchschnitt","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"category","in":"query","schema":{"type":"string"},"description":"Kategorie-Slug, siehe /categories"},{"name":"min_price","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Produkte mit Rabatt","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"category":{"type":["string","null"]},"basis":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"url":{"type":"string","format":"uri","description":"Produktseite mit Preisvergleich"},"image":{"type":["string","null"],"format":"uri"},"category":{"type":["object","null"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"}}},"manufacturer":{"type":["object","null"],"properties":{"id":{"type":"integer"},"name":{"type":"string"}}},"ean":{"type":["string","null"]},"price_min":{"type":["number","null"],"description":"Günstigster Preis in EUR inkl. MwSt."},"offer_count":{"type":"integer"},"bv_score":{"type":["integer","null"],"description":"BestenVergleich-Score 0–100 (Tests, Preis-Leistung, Beliebtheit)"},"rating":{"type":["number","null"],"description":"Testnote 0–100 aus Fachmagazinen"},"test_count":{"type":"integer"},"is_discount":{"type":"boolean"},"discount_pct":{"type":["integer","null"]},"price_old":{"type":["number","null"]}}}},"disclosure":{"type":"string"}}}}}}}}},"/categories":{"get":{"operationId":"listCategories","summary":"Alle Kategorien mit Produktanzahl","responses":{"200":{"description":"Kategorien","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"parent_id":{"type":["integer","null"]},"product_count":{"type":"integer"},"url":{"type":"string"}}}}}}}}}}}},"/go/{offerId}":{"get":{"operationId":"goToOffer","summary":"Weiterleitung zum Shop-Angebot (302, Affiliate-Link)","parameters":[{"name":"offerId","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"302":{"description":"Redirect zum Shop"},"404":{"description":"Angebot nicht gefunden"}}}}}}