Folder API
Een gratis, open en read-only databron met de actuele reclamefolders in Nederland. Geen account, geen tracking. Je krijgt welke folders er nu lopen per winkel, hun geldigheidsperiode (validFrom en validUntil) en een deeplink naar de folder. Dagelijks automatisch bijgewerkt.
Voor alcohol (bier, wijn, sterke drank) krijg je ook de volledige aanbieding-labels. Voor overige categorieen delen we het folder-niveau plus een deeplink, zodat je verder kijkt op folderwijzer.nl.
Let op: dit is geen prijsvergelijking. Het veld price is de
letterlijke folderlabel (bijvoorbeeld "25% korting"), geen berekende prijs.
Endpoints
| GET | /api/v1/folders.json | Alle lopende folders + index van ketens en feeds |
| GET | /api/v1/folders/[keten].json | Folders van een keten, inclusief aanbieding-labels |
| GET | /api/v1/feeds/[keten].xml | RSS feed: nieuwe folder van een keten |
| GET | /api/v1/feeds/[keten].json | JSON Feed (jsonfeed.org) van een keten |
| GET | /api/v1/ical/[keten].ics | iCal: abonneer op de folderperiodes van een keten |
Voorbeelden
# Alle lopende folders (index van ketens en feeds)
curl https://folderwijzer.nl/api/v1/folders.json
# Folders van een keten, met aanbieding-labels
curl https://folderwijzer.nl/api/v1/folders/albert-heijn.json
# RSS feed: nieuwe folder van een keten
curl https://folderwijzer.nl/api/v1/feeds/albert-heijn.xml
# iCal: abonneer in je agenda op de folderperiodes
curl https://folderwijzer.nl/api/v1/ical/albert-heijn.icsVelden
retailer: slug en naam van de winkel.validFrom/validUntil: geldigheidsperiode (ISO datum), afgelezen van de folder.url: deeplink naar de folder op folderwijzer.nl.offerCount: totaal aantal aanbiedingen in de folder (alle categorieen).alcoholOfferCount: aantal alcohol-aanbiedingen waarvan de labels worden gedeeld.offers[]: alleen voor alcohol (bier, wijn, sterke drank), per aanbieding de labels:product,brand,price(letterlijke label),promo,size,category,tags,description,url. Overige categorieen: gebruikofferCountplus de folder-url.
Beschikbare ketens
Albert Heijn, Aldi, Boni, Boons Markt, Dekamarkt, Dirk, Gall & Gall, Hoogvliet, Jumbo, Kruidvat, Lidl, Makro, MCD Supermarkt, Nettorama, Plus, Poiesz, Sligro, Spar, Trekpleister, Vomar, Xenos
Gebruik en bronvermelding
Vrij te gebruiken voor je app, site of project, ook commercieel. Eén voorwaarde: vermeld de bron met een zichtbare link naar folderwijzer.nl. Wees aardig voor de server (de bestanden zijn gecachet en dagelijks ververst, dus één keer per dag ophalen is genoeg). Read-only, geen login.
Bron: Folderwijzer, folders en aanbiedingen uit heel Nederland.