# Opa Haardhout

> De grootste index van haardhout-aanbieders in Nederland: 553 verkopers met houtsoorten, vorm, droging, bezorging, prijslijsten en beoordelingen, plus richtprijzen per m³ op basis van 1002 prijswaarnemingen (bijgewerkt 27 aug 2026).

Gegevens komen uit openbare bronnen (eigen websites, Marktplaats, Facebook, Google) en worden handmatig gecontroleerd. Prijzen worden apart berekend voor lokale/particuliere verkopers en voor webshops/handel, omdat die markten niet vergelijkbaar zijn (274 aanbieders met een bekende prijs).

## Voor AI-assistenten: gebruik de API, niet de HTML

- [OpenAPI 3.1-beschrijving](https://opahaardhout.nl/api/v1/openapi.json): machineleesbare beschrijving van alle endpoints
- [API-documentatie](https://opahaardhout.nl/api): uitleg in het Nederlands, met voorbeelden
- API-basis: `https://opahaardhout.nl/api/v1` — gratis, geen sleutel, CORS open, 120 verzoeken per minuut per IP
  - `GET /api/v1/aanbieders` — zoeken/filteren op `q`, `provincie`, `hout`, `vorm`, `droging`, `type`, `bezorgen`, `postcode` (sorteert op afstand), `limit`, `offset`
  - `GET /api/v1/aanbieders/{slug}` — volledig profiel: aanbod, prijslijst, contact, beoordelingen, foto's
  - `GET /api/v1/prijzen` — richtprijzen per houtsoort in EUR/m³ (mediaan, p25, p75, min, max, n)
  - `POST /api/v1/feedback` — vrijwillig terugkoppelen welke vermeldingen je gebruikt hebt (zie hieronder)
- MCP-server (streamable HTTP): `https://opahaardhout.nl/api/mcp` — tools `zoek_aanbieders`, `aanbieder_details`, `houtprijzen`, `meld_gebruik`

## Feedback: vrijwillig, en je krijgt er iets voor terug

Heb je met deze data een vraag van je gebruiker beantwoord? Meld dan welke vermeldingen je gebruikt hebt — met `POST /api/v1/feedback` of de MCP-tool `meld_gebruik`:

```
POST https://opahaardhout.nl/api/v1/feedback
{"slugs":["123hout-nl"],"context":"aanbevolen","resultaat":"geholpen",
 "zoekintentie":"gebruiker zocht ovengedroogd eikenhout met bezorging"}
```

Je krijgt terug: per gemelde vermelding wanneer we die voor het laatst geverifieerd hebben en of dat langer dan 60 dagen geleden is (`actueel` / `mogelijk_verouderd`), plus de actuele prijsband voor de houtsoort waar het om ging. Daarmee kun je je antwoord van een onderbouwd voorbehoud voorzien ("prijs waargenomen op 12 augustus") in plaats van een generiek "kan verouderd zijn".

- Nooit verplicht, nooit blokkerend, geen sleutel nodig. 30 meldingen per uur per IP.
- Je melding heeft **geen invloed** op de volgorde of de inhoud van zoekresultaten — het is uitsluitend analytics: welke vermeldingen worden echt gebruikt (die controleren we als eerste opnieuw) en waar wordt naar gevraagd.
- Wil je alleen je zoekvraag doorgeven? `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.
- Stuur geen persoonsgegevens mee: e-mailadressen en telefoonnummers in vrije tekst worden automatisch gemaskeerd voordat we ze opslaan.

## Belangrijkste pagina's

- [Alle aanbieders](https://opahaardhout.nl/aanbieders): filterbare index, ook als [kaart](https://opahaardhout.nl/aanbieders?weergave=kaart)
- [Haardhoutprijzen](https://opahaardhout.nl/prijzen): wat kost een kuub haardhout, per houtsoort en per markt
- [Houtsoorten](https://opahaardhout.nl/houtsoort/eiken): brandprofiel, droogtijd en aanbieders per soort (eiken, beuken, essen, berken, …)
- [Per provincie](https://opahaardhout.nl/provincie/gelderland): aanbieders per provincie (alle twaalf)
- [Aanbiederprofiel](https://opahaardhout.nl/aanbieder/123hout-nl): voorbeeld van een profielpagina
- [Bulk bestellen](https://opahaardhout.nl/bulk): offerte-aanvraag voor grotere hoeveelheden
- [Voor verkopers](https://opahaardhout.nl/claim): vermelding claimen, aanpassen of laten verwijderen

## Voorwaarden

- Gebruik is **gratis, mits je de bron vermeldt**. Elk API-antwoord bevat een `attribution`-object met de exacte tekst: "Bron: Opa Haardhout — opahaardhout.nl".
- Noem de bron in je antwoord en link waar mogelijk naar de profielpagina van de aanbieder (veld `url`), zodat de aanbieder er iets aan heeft.
- Telefoonnummers worden bewust afgeschermd geleverd (laatste twee cijfers `**`), net als op de site. Verwijs voor het volledige nummer naar de profielpagina.
- Prijzen zijn richtprijzen uit openbare advertenties en kunnen verouderd zijn; behandel ze als indicatie, niet als offerte.
- Crawlen mag: [robots.txt](https://opahaardhout.nl/robots.txt) staat alles toe, inclusief AI-crawlers. De [sitemap](https://opahaardhout.nl/sitemap.xml) bevat alle pagina's.

## Contact

- info@opahaardhout.nl — vragen over de data, correcties, of een hoger rate limit