Zoeken in het Onderwijsloket – Werken met de Onderwijsloket API (3/4)
Het platform van het Onderwijsloket bevat een grote hoeveelheid informatie: artikelen, FAQ’s, opleidingen, media, routes naar het onderwijs en meer. Voor gebruikers is het essentieel dat ze snel vinden wat voor hen relevant is.
Ondanks deze grote hoeveelheid aan informatie, willen we dat de gebruiker wél snel vindt waar hij of zij naar op zoek is. En daar komt de search engine in beeld. In dit artikel laten we zien hoe je met de zoeklaag van het Onderwijsloket krachtige zoekervaringen kunt bouwen – van eenvoudige zoekbalken tot slimme navigators.
Zoeken als gebruikersinterface
Waar de Content API draait om het ophalen van specifieke data, draait de search engine om interactie. Gebruikers weten vaak niet precies wat ze zoeken: ze hebben een vraag, een situatie of een interesse. De zoekervaring helpt hen om vanuit die vraag tot relevante informatie te komen.
Denk aan:
een zoekbalk met directe suggesties
filters op onderwerp, sector of doelgroep
een overzicht van resultaten dat zich dynamisch aanpast
In veel toepassingen vormt de search engine daarmee het startpunt van de interactie met de gebruiker.
Eén zoekopdracht, meerdere datasets
Een belangrijk kenmerk van de zoeklaag is dat één zoekopdracht resultaten kan opleveren uit verschillende datasets tegelijk.
Een gebruiker die zoekt op “zij-instroom” kan bijvoorbeeld tegelijk zien:
artikelen over zij-instroom
opleidingen die daarbij passen
FAQ’s met praktische vragen
ervaringsverhalen van anderen
Voor ontwikkelaars betekent dit dat je geen aparte queries hoeft te doen per dataset: de zoeklaag combineert dit al voor je. Daardoor kun je relatief eenvoudig rijke zoekervaringen bouwen, zonder complexe logica aan de voorkant.
Relevantie en snelheid
De search engine van het Onderwijsloket is gebouwd op Algolia en geoptimaliseerd voor snelheid en relevantie.
Zoekresultaten worden niet alleen gebaseerd op letterlijke matches, maar ook op:
synoniemen en variaties
populariteit en gebruik
context van de content
Daardoor voelt de zoekervaring “slim”: gebruikers krijgen vaak al relevante resultaten voordat ze hun volledige vraag hebben getypt. Voor toepassingen betekent dit dat je kunt vertrouwen op de zoeklaag voor het ordenen van resultaten.
Filteren en verfijnen
Naast zoeken is filteren een essentieel onderdeel van de gebruikerservaring. Omdat de zoekindex gebruikmaakt van dezelfde taxonomie als het datamodel (onderwerpen, sectoren, doelgroepen), kun je resultaten eenvoudig verfijnen.
Bijvoorbeeld:
alleen opleidingen binnen een bepaalde sector
alleen artikelen voor een specifieke doelgroep
alleen resultaten binnen een bepaalde regio
Filters maken het mogelijk om van een brede zoekopdracht naar een concrete keuze te gaan en helpen gebruikers om sneller tot een relevant resultaat te komen.
Van zoekresultaat naar detail
In veel toepassingen gebruik je de search engine en de Content API samen.
De search engine wordt gebruikt om:
een lijst met relevante resultaten op te halen
snel te reageren op gebruikersinput
De Content API gebruik je vervolgens om:
de volledige inhoud van een item op te halen
detailpagina’s op te bouwen
gerelateerde informatie toe te voegen
Dit patroon zie je in vrijwel elke implementatie: zoeken → selecteren → verdiepen, waarbij de zoeklaag zorgt voor snelheid en de Content API voor diepgang.
Wat kun je bouwen?
Met de zoeklaag van het Onderwijsloket kun je verschillende soorten toepassingen realiseren:
een zoekbalk voor de kennisbank
een thematische navigator (bijvoorbeeld rond zij-instroom of omscholing)
een filterinterface voor opleidingen of artikelen
een gepersonaliseerde ontdekervaring op basis van interesses
Omdat de zoeklaag meerdere datasets combineert, kun je snel rijke interfaces bouwen zonder alles zelf te structureren of te koppelen.
Aan de slag
Wil je zelf een zoekervaring bouwen met de Onderwijsloket API? In de developer documentatie vind je:
uitleg over de beschikbare search indices
configuratie van filters en facetten
voorbeelden van zoekqueries
best practices voor het opbouwen van een zoekinterface
In het volgende artikel
In het volgende en laatste artikel leggen we de focus op geografische en regionale aspecten binnen de API. Wat ook de vraag "wat zit er allemaal bij mij in de buurt?" kan het Onderwijsloket beantwoorden.
