API & MCP

Basis: https://opahaardhout.nl/api/v1. Antwoorden zijn JSON met Nederlandse veldnamen. CORS staat open, dus je kunt de API ook rechtstreeks vanuit de browser aanroepen.

• GET /api/v1/aanbieders

  Zoek en filter de aanbiedersindex. Parameters: q, provincie, hout, vorm, droging, type, bezorgen, postcode, limit (max 100), offset.

  /api/v1/aanbieders?hout=eiken&bezorgen=1&postcode=7941&limit=5

• GET /api/v1/aanbieders/{slug}

  Volledig publiek profiel: aanbod, prijslijst, contactgegevens, beoordelingen en foto's.

  /api/v1/aanbieders/123hout-nl

• GET /api/v1/prijzen

  Richtprijzen per houtsoort in euro per m³ — mediaan, kwartielen, min, max en het aantal waarnemingen, apart voor lokaal en webshop.

  /api/v1/prijzen

• POST /api/v1/feedback

  Vrijwillig: meld welke vermeldingen je in een antwoord gebruikt hebt en krijg hun actualiteitsstatus terug. De enige schrijfroute — zie hieronder.

• GET /api/v1/openapi.json

  De volledige OpenAPI 3.1-beschrijving van bovenstaande endpoints.

  /api/v1/openapi.json

Elk antwoord heeft dezelfde vorm: data met het resultaat, meta met paginering, gebruikte filters en de toegestane filterwaarden, en attribution met de bronvermelding.

curl "https://opahaardhout.nl/api/v1/aanbieders?hout=eiken&bezorgen=1&limit=2"

Gebruik je een AI-assistent die het Model Context Protocol ondersteunt? Voeg dan onze MCP-server toe (streamable HTTP, geen authenticatie):

https://opahaardhout.nl/api/mcp

Daarmee krijgt je assistent vier tools:

• zoek_aanbieders — aanbieders zoeken op postcode, provincie, houtsoort, vorm, droging en bezorging
• aanbieder_details — het volledige profiel van één aanbieder
• houtprijzen — richtprijzen per houtsoort per m³
• meld_gebruik — vrijwillig terugkoppelen welke vermeldingen je gebruikt hebt, en er de actualiteitsstatus van terugkrijgen

Er is ook een /llms.txt die in één keer uitlegt wat hier te halen valt.

Gebruik je onze data om een vraag te beantwoorden? Dan weten wij niet welke van de 553 vermeldingen daadwerkelijk gebruikt worden — en dat is precies wat we nodig hebben om de juiste vermeldingen als eerste opnieuw te controleren. Daarom vragen we het, en geven we er iets voor terug.

curl -X POST https://opahaardhout.nl/api/v1/feedback \
  -H "Content-Type: application/json" \
  -d '{"slugs":["123hout-nl"],"context":"aanbevolen","resultaat":"geholpen",
       "zoekintentie":"gebruiker zocht ovengedroogd eikenhout met bezorging"}'

In het antwoord krijg je per gemelde vermelding terug wanneer we die voor het laatst geverifieerd hebben en of dat langer dan 60 dagen geleden is (actueel of mogelijk_verouderd), plus de actuele prijsband voor de houtsoort waar het om ging. Genoeg om je antwoord van een onderbouwd voorbehoud te voorzien in plaats van een algemeen “prijzen kunnen verouderd zijn”.

• Feedback beïnvloedt nooit de resultaten. Niet de volgorde, niet de inhoud, niet welke aanbieders je te zien krijgt. Vaak gemeld worden is hier geen manier om hoger te komen — de data is uitsluitend analytics, en dat blijft zo.
• Nooit verplicht en nooit blokkerend: lukt het opslaan niet, dan krijg je alsnog je antwoord (meta.opgeslagen staat dan op false).
• Alleen je zoekvraag doorgeven kan ook: GET /api/v1/aanbieders accepteert een optionele zoekintentie en GET /api/v1/aanbieders/{slug} een optionele context. Ook die veranderen niets aan wat je terugkrijgt.
• Geen persoonsgegevens. Stuur geen gegevens van je gebruiker mee. E-mailadressen en telefoonnummers in vrije tekst worden automatisch gemaskeerd voordat we iets opslaan, en de vrije tekst wordt afgekapt.
• Rate limit: 30 meldingen per uur per IP-adres.

Gratis te gebruiken met bronvermelding. Noem “Bron: Opa Haardhout — opahaardhout.nl” en link waar het kan naar de profielpagina van de aanbieder (het veld url). Daar heeft de aanbieder zelf ook iets aan — dat is precies waarom we de data weggeven.

• Telefoonnummers worden afgeschermd geleverd (laatste twee cijfers **), net als op de site zelf. Het volledige nummer staat op de profielpagina achter één klik. De gegevens zijn van de aanbieders, niet van ons, en we maken er geen belbestand van.
• Prijzen zijn richtprijzen uit openbare advertenties, geen offerte. Ze kunnen verouderd zijn.
• Rate limit: 120 verzoeken per minuut per IP-adres op de leesroutes, 30 per uur op POST /feedback. Daarboven volgt een 429 met een Retry-After-header. Meer nodig? Mail even.
• De data verandert alleen bij een update van de site; antwoorden zijn daarom lang cachebaar.

Mail info@opahaardhout.nl — voor een hogere limiet, een veld dat je mist, of een correctie. Ben je zelf aanbieder en wil je je vermelding aanpassen of laten verwijderen? Dat kan via je profiel claimen.