Open data & API
De website is maar één venster: alles wat hier publiek staat, is ook machineleesbaar. Overheden, onderzoekers, journalisten en bouwers gebruiken dezelfde bron als wij, met dezelfde eerlijkheidsregels: onbekend blijft onbekend, elke claim draagt zijn bron.
Nu in het register: 80.808 echte zaken · 606 gemeenten · 14 vetten · 283 beweringen met lifecycle.
| Endpoint | Wat |
|---|---|
/api/v1/fats | Canonieke vetten-ontologie |
/api/v1/vetkaart | Zaken met vet-claim, status en datakwaliteit (categoryConfident, categorySource) |
/api/v1/venues/{slug} | Venue-dossier |
/api/v1/venues/{slug}/journey | Bron-tot-mond journey (7 stappen, fog = onbekend) |
/api/v1/venues/{slug}/badge | Menukaart-badge (SVG + QR) |
/api/v1/municipalities/{slug}/coverage | Gemeente-dekking (methodologie-versioned) |
/api/v1/echo/feed | Factuele gebeurtenissen-feed met publiceer-gates |
Attributie: "Bron: OilScore". Bulk of onderzoek-datasets: mail ons. OpenAPI-contract zit in de repo (openapi/oilscore.v1.yaml).
Fair use: vrij raadpleegbaar, bulk via sleutel
Het register is en blijft vrij raadpleegbaar: elke dossierpagina staat open, zonder login, zonder captcha, zonder JavaScript-verplichting. Wie de data in bulk wil, hoeft niet te scrapen: vraag hieronder een gratis sleutel aan en je krijgt volledige antwoorden langs de voordeur. Wij meten wie wat consumeert en handhaven deze grenzen:
- Zonder sleutel: 120 API-requests per uur per IP, maximaal 100 zaken per vetkaart-antwoord.
- Zoeken zonder sleutel: 30 zoekopdrachten per uur per IP.
- Zonder sleutel geeft het venue-dossier geen bronsysteem-referenties (externalRefs); contactgegevens zitten nooit in de publieke API.
- Scripts zonder eigen User-Agent of met bekende scraper-signaturen krijgen op de API een 429 met verwijzing naar deze pagina. Met je sleutel werkt elke client, ook curl.
- HTML-dossiers: meer dan 300 dossierpagina's per uur vanaf één IP krijgt een pauze (429 met Retry-After). Zoekmachines zijn uitgezonderd. Dit is bewust best-effort: geen captcha, geen tracking.
Waarom zo: de open-databelofte is de kern van dit project, maar een register dat leeggezogen en zonder context herverpakt wordt, verliest zijn bronvermelding en zijn eerlijkheidsregels (onbekend blijft onbekend). Bulk via sleutel houdt de bron gezond en de attributie intact.
🔑 API-sleutel aanvragen
De publieke API is bewust bescheiden; met een gratis sleutel krijg je volledige antwoorden en een eigen uurlimiet. Vertel kort waarvoor je de data gebruikt: zo weten we wie er op het register bouwt en houden we de bron gezond. Gebruik je sleutel als Authorization: Bearer wf_live_… of ?api_key=.