Overzicht
De OnderzoekPortaal.NL API biedt ontwikkelaars en onderzoekers programmatische toegang tot onze uitgebreide database van wetenschappelijke onderzoeken. Onze REST API retourneert gestructureerde data in JSON-formaat.
Authenticatie
Voor toegang tot de API is een API-sleutel vereist. Neem contact met ons op via api@onderzoekportaal.nl voor toegang.
Endpoints
Onderzoeken ophalen
GET
/api/v1/onderzoeken
Haalt een lijst van onderzoeken op met optionele filters.
Parameters
categorie- Filter op categorie (consumenten, criminaliteit, gezondheid, etc.)datum- Filter op publicatiedatum (YYYY-MM-DD)zoekterm- Zoek in titel en beschrijvinglimiet- Aantal resultaten (standaard: 20, max: 100)offset- Startpositie voor paginering
Voorbeeld Request
GET /api/v1/onderzoeken?categorie=consumenten&limiet=10
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Voorbeeld Response
{
"status": "success",
"data": {
"onderzoeken": [
{
"id": "123",
"titel": "Consumentengedrag 2025",
"beschrijving": "Analyse van koopgedrag in Nederland",
"categorie": "consumenten",
"auteur": "Dr. J. van der Berg",
"publicatiedatum": "2025-01-15",
"url": "/onderzoeken/consumentengedrag-2025/"
}
],
"totaal": 150,
"limiet": 10,
"offset": 0
}
}
Rate Limiting
De API hanteert een limiet van 1000 requests per uur per API-sleutel. Bij overschrijding ontvangt u een HTTP 429 status code.
Foutafhandeling
De API gebruikt standaard HTTP status codes:
200- Success400- Bad Request401- Unauthorized429- Too Many Requests500- Internal Server Error
Contact
Voor vragen over de API, technische ondersteuning of toegangsaanvragen:
Email: api@onderzoekportaal.nl