{"openapi":"3.1.0","info":{"title":"Prijzo API","version":"1.0.0","summary":"Alleen-lezen catalogus van prijzo.nl.","description":"Prijzo vergelijkt producten in Nederland op EAN, met prijsgeschiedenis en eerlijke koopgidsen. Geen verzonnen prijzen. Geen API-sleutel. Alleen GET. Antwoorden zijn JSON, UTF-8. Een product zonder partnerfeed houdt priceStatus \"demo\": Prijzen zijn voorbeelden tot de winkelkoppelingen live staan. url en affiliateUrl zijn dan null en elk bedrag is een voorbeeldprijs. Een product met een feedprijs krijgt priceStatus \"live\", de feedprijs en een winkellink. lows wordt tijdens het bouwen van de site berekend uit priceHistory: per winkel de laagste priceCents in een rollend venster van 30, 90 en 365 keer 24 uur. Amazon-prijzen zitten niet in priceHistory en niet in lows. Een Amazon-aanbieding toont alleen de actuele prijs. Citeer een bedrag alleen samen met priceStatus. Een MCP-server hoort nog niet bij deze specificatie.","contact":{"email":"info@prijzo.nl","url":"https://prijzo.nl/contact/"}},"servers":[{"url":"https://prijzo.nl","description":"prijzo.nl"}],"tags":[{"name":"Catalogus","description":"Producten, categorieën, gidsen en de zoekindex."}],"paths":{"/api/products.json":{"get":{"tags":["Catalogus"],"operationId":"listProducts","summary":"Alle producten","responses":{"200":{"description":"Lijst van producten, gesorteerd op naam.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}}}}},"/api/products/{id}.json":{"get":{"tags":["Catalogus"],"operationId":"getProduct","summary":"Eén product","description":"Alleen ids uit /api/products.json bestaan als bestand.","parameters":[{"name":"id","in":"path","required":true,"description":"Product-id, bijvoorbeeld philips-airfryer-hd9280-91.","schema":{"type":"string"}}],"responses":{"200":{"description":"Het product.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}}}}},"/api/categories.json":{"get":{"tags":["Catalogus"],"operationId":"listCategories","summary":"Categorieën","responses":{"200":{"description":"Categorieën op volgorde van de catalogus.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Category"}}}}}}}},"/api/guides.json":{"get":{"tags":["Catalogus"],"operationId":"listGuides","summary":"Koopgidsen","description":"Zonder de lopende tekst. Die staat op de HTML-pagina en in /md/gids/{id}.md.","responses":{"200":{"description":"Gidsen, recentst bijgewerkt eerst.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Guide"}}}}}}}},"/api/search.json":{"get":{"tags":["Catalogus"],"operationId":"searchIndex","summary":"Zoekindex","description":"Platte index voor zoeken in de browser. Bevat geen prijzen.","responses":{"200":{"description":"Producten en gidsen.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SearchHit"}}}}}}}},"/api/openapi.json":{"get":{"tags":["Catalogus"],"operationId":"getOpenApi","summary":"Deze specificatie","responses":{"200":{"description":"OpenAPI-document.","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Offer":{"type":"object","additionalProperties":false,"required":["vendorId","priceCents","currency","url","affiliateUrl","inStock","lastChecked","demo"],"properties":{"vendorId":{"type":"string"},"priceCents":{"type":"integer","minimum":1,"description":"Prijs in eurocenten."},"currency":{"type":"string","const":"EUR"},"url":{"type":["string","null"],"description":"Product-URL. Null zolang de prijs een voorbeeld is."},"affiliateUrl":{"type":["string","null"],"description":"Partnerlink. Null zolang de prijs een voorbeeld is."},"inStock":{"type":["boolean","null"]},"lastChecked":{"type":"string","description":"Datum van het punt, YYYY-MM-DD. In demomodus geen controledatum op de site."},"demo":{"type":"boolean"}}},"PricePoint":{"type":"object","additionalProperties":false,"required":["date","vendorId","priceCents"],"properties":{"date":{"type":"string","description":"YYYY-MM-DD"},"vendorId":{"type":"string"},"priceCents":{"type":"integer","minimum":1}}},"VendorLow":{"type":"object","additionalProperties":false,"required":["vendorId","priceCents","observedAt"],"properties":{"vendorId":{"type":"string"},"priceCents":{"type":"integer","minimum":1,"description":"Laagste priceCents van deze winkel in het venster."},"observedAt":{"type":"string","description":"Datum van het punt dat deze laagste prijs zette."}}},"PriceLows":{"type":"object","additionalProperties":false,"required":["days30","days90","days365"],"properties":{"days30":{"type":"array","items":{"$ref":"#/components/schemas/VendorLow"},"description":"Laagste prijs per winkel in 30 × 24 uur."},"days90":{"type":"array","items":{"$ref":"#/components/schemas/VendorLow"},"description":"Laagste prijs per winkel in 90 × 24 uur."},"days365":{"type":"array","items":{"$ref":"#/components/schemas/VendorLow"},"description":"Laagste prijs per winkel in 365 × 24 uur."}}},"Product":{"type":"object","additionalProperties":false,"required":["id","name","brand","model","ean","eanNote","category","subcategory","summary","description","specs","pros","cons","sources","guides","offers","priceHistory","lows","priceStatus","demo","priceNotice","updatedAt","url"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"brand":{"type":"string"},"model":{"type":"string"},"ean":{"type":["string","null"],"description":"GTIN-13, alleen als die uitvoering gecontroleerd is."},"eanNote":{"type":["string","null"]},"category":{"type":"string"},"subcategory":{"type":"string"},"summary":{"type":"string"},"description":{"type":"string"},"specs":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["label","value"],"properties":{"label":{"type":"string"},"value":{"type":"string"}}}},"pros":{"type":"array","items":{"type":"string"}},"cons":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["label","url"],"properties":{"label":{"type":"string"},"url":{"type":"string"}}}},"guides":{"type":"array","items":{"type":"string"},"description":"Ids van koopgidsen."},"offers":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}},"priceHistory":{"type":"array","items":{"$ref":"#/components/schemas/PricePoint"},"description":"Vastgelegde prijzen. Amazon-prijzen zitten niet in priceHistory."},"lows":{"$ref":"#/components/schemas/PriceLows","description":"Laagste prijs per winkel. Amazon-prijzen zitten niet in days30, days90 of days365."},"priceStatus":{"type":"string","enum":["live","demo","pending_feed"]},"demo":{"type":"boolean"},"priceNotice":{"type":["string","null"]},"updatedAt":{"type":"string"},"url":{"type":"string","description":"Canonieke HTML-pagina van het product."}}},"Category":{"type":"object","additionalProperties":false,"required":["id","title","description","intro","flagship","subcategories","url"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"intro":{"type":"string"},"flagship":{"type":"boolean"},"subcategories":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["slug","title","description"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}}}},"url":{"type":"string"}}},"Guide":{"type":"object","additionalProperties":false,"required":["id","title","description","category","flagship","publishedAt","updatedAt","products","faqs","url"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"flagship":{"type":"boolean"},"publishedAt":{"type":"string"},"updatedAt":{"type":"string"},"products":{"type":"array","items":{"type":"string"}},"faqs":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["question","answer"],"properties":{"question":{"type":"string"},"answer":{"type":"string"}}}},"url":{"type":"string"}}},"SearchHit":{"type":"object","additionalProperties":false,"required":["type","title","url","category","text"],"properties":{"type":{"type":"string","enum":["product","guide"]},"title":{"type":"string"},"url":{"type":"string","description":"Pad op deze site, beginnend met /."},"category":{"type":"string"},"text":{"type":"string"}}}}}}