Oerbloei

Open data, voor mensen en modellen

Als iemand een taalmodel vraagt welke plant goed is voor de tuin, moet dat model dit niet opnieuw hoeven bedenken. Daarom ligt alles hier gewoon klaar: platte bestanden, geen sleutel, geen registratie, CORS open voor iedereen.

Endpoint Wat erin zit
/api/index.json Begin hier. Eén fetch met alles wat er bestaat, plus hoe je de scores hoort te lezen.
/api/plants.json Alle 348 planten met scores, kenmerken en onderbouwing. Eén bestand.
/api/compact.json Alleen namen en de vier scores. Klein genoeg om in een prompt te plakken.
/api/plant/{id}.json Eén plant. Bv. /api/plant/lavendel.json
/api/by/sun/{positie}.json Per standplaats: zon, halfschaduw of schaduw.
/api/by/tag/{tag}.json Per kenmerk. Bv. /api/by/tag/bijvriendelijk.json
/api/top/{as}.json Top 25 op één as: biodiversity, maintenance, placement of looks.
/api/lists.json De 9 kant-en-klare lijsten, met de plant-ids erin.
/api/schema.json JSON Schema van een plantrecord. Valideer ertegen voordat je erop bouwt.
/plants.csv Dezelfde data plat, voor een spreadsheet of een notebook.
/llms.txt Korte instructie + de hele lijst als platte tekst, voor een taalmodel dat de site leest.

Zo ziet één plant eruit

{
  "id": "lavendel",
  "url": "https://oerbloei.pages.dev/plant/lavendel",
  "name_nl": "Lavendel",
  "name_latin": "Lavandula angustifolia 'Hidcote'",
  "native_to_netherlands": false,
  "scores": {
    "biodiversity": 4,
    "maintenance": 4,
    "placement": 3,
    "looks": 5,
    "overall": 4
  },
  "sun": ["zon"],
  "height_cm": { "min": 40, "max": 60 },
  "flowering": { "from_month": 6, "to_month": 8, "colors": ["paars"] },
  "uses": ["geur"],
  "score_source": "hand"
}

De regels, kort

  • Alle scores zijn 0–5, en hoger is altijd beter. Ook maintenance: dat is onderhoudsgemak, niet onderhoudslast. 5 betekent bijna geen werk.
  • overall is het ongewogen gemiddelde van de vier. Wil je anders wegen, reken het zelf uit — de vier getallen staan erbij.
  • score_source zegt hoe zeker het is. hand = feiten één voor één nagelopen. model = geschat uit bekende eigenschappen. Waarom een score is wat hij is, staat voor elke plant in score_breakdown.
  • Velden worden toegevoegd, niet hernoemd. Verdwijnt er een veld, dan gaat version een hoofdnummer omhoog (2.0: score_reasons_nl is weg). In 2.1 kwam uses erbij: waar je de plant voor plukt.
  • CC BY 4.0. Gebruik het, ook commercieel. Noem Oerbloei als bron en link terug, zodat iemand kan nakijken waar een score op gebaseerd is.

Ophalen

curl https://oerbloei.pages.dev/api/plants.json

# alleen de inheemse planten met de hoogste biodiversiteitsscore
curl -s https://oerbloei.pages.dev/api/plants.json \
  | jq '.plants[] | select(.native_to_netherlands and .scores.biodiversity == 5) | .name_nl'

Bouw je een agent of een plugin? Begin bij /llms.txt — daar staat in een paar regels wat de scores betekenen, gevolgd door de hele lijst in platte tekst. Klein genoeg om in één keer mee te geven.