API-toegang tot repositories: voor onderzoekers die data programmatisch willen ophalen

Je wilt graag datasets uit een repository gebruiken voor je onderzoek, maar je hebt geen zin om handmatig door honderden bestanden te scrollen of steeds opnieuw te downloaden.

Gelukkig hoeft dat niet meer. Met een API kun je data programmatisch ophalen — dus automatisch, snel en precies op maat. In dit artikel lees je wat een API precies is, waarom het zo handig is voor onderzoekers, welke repositories een API aanbieden, en hoe je er zelf mee aan de slag gaat.

Wat is een API eigenlijk?

API staat voor Application Programming Interface. Dat klinkt ingewikkeld, maar het idee is simpel.

Een API is een soort toegangspoort waarmee software met elkaar kan praten. Stel: je wilt weten welke datasets er in een repository staan over klimaatverandering. In plaats van zelf op zoek te gaan via de website, stuur je via de API een vraag naar de server.

De server antwoordt met de juiste data — vaak in een gestructureerd formaat zoals JSON of XML.

Je hoeft dus niets te klikken of te downloaden. Je schrijft een klein stukje code, en de API doet de rest. Handig, toch?

Waarom is API-toegang zo waardevol voor onderzoekers?

Veel onderzoekers werken tegenwoordig met grote hoeveelheden data. Denk aan genoomdata, satellietbeelden, of miljoenen sociale media-berichten.

Die data zit vaak opgeslagen in repositories zoals Zenodo, Figshare of Dataverse. Maar hoe krijg je die data efficiënt binnen? API-toegang biedt vier grote voordelen: Kortom: je bespaart tijd, vermindert fouten, en kunt je focussen op wat echt telt — je onderzoek.

• Automatisering: Je kunt scripts schrijven die automatisch nieuwe datasets ophalen zodra ze beschikbaar zijn. Geen handmatig werk meer.
• Precisie: Je vraagt alleen op wat je echt nodig hebt — bijvoorbeeld alleen datasets uit 2023, of alleen die met een bepaald trefwoord.
• Integratie: Je kunt de data direct doorsturen naar je analyseprogramma, zoals Python of R. Geen tussenstap van downloaden en opslaan.
• Schaalbaarheid: Of je nu 10 of 10.000 datasets nodig hebt, een API kan het aan.

Welke repositories bieden een API?

Niet elke repository heeft een API, maar de belangrijkste voor onderzoekers in Nederland en daarbuiten wel. Hier een overzicht:

Zenodo

Zenodo is een populaire open access repository voor onderzoekdata en publicaties. Ze bieden een RESTful API die je toegang geeft tot alle metadata en bestanden. Je kunt zoeken, ophalen en zelfs uploaden via de API. En het mooie: het is gratis en je hebt geen account nodig om te beginnen.

Figshare

Figshare is een platform waar onderzoekers data, figuren en andere onderzoeksmaterialen delen. Hun API werkt met JSON en biedt endpoints voor zoeken, ophalen en uploaden.

Dataverse

Handig als je werkt met visuele data of supplementaire bestanden. Dataverse is een open source-platform dat veel wordt gebruikt door universiteiten.

European Nucleotide Archive (ENA)

Ze bieden API’s in meerdere programmeertalen, waaronder Python, R en JavaScript. Je kunt niet alleen data ophalen, maar ook metadata beheren en zelfs nieuwe datasets aanmaken via de API. Werken met genomische data?

Dryad

Dan is ENA je beste vriend. Ze bieden een gespecialiseerde API voor het ophalen van DNA- en RNA-sequenties.

De API is gebouwd voor grote datasets en ondersteunt geavanceerde zoekopdrachten. Dryad richt zicht op data die wordt gebruikt in wetenschappelijke publicaties. Hun API maakt het makkelijk om datasets te doorzoeken met Python, of om zelf data te delen volgens de FAIR-principes.

Welke tools gebruik je om met API’s te werken?

Je hebt geen expert hoeft te zijn om met API’s te werken. Er zijn gebruiksvriendelijke tools beschikbaar in veel programmeertalen:

• Python: De bibliotheek requests maakt het makkelijk om verzoeken te sturen naar een API. Combineer het met json om de antwoorden te verwerken.
• R: Gebruik het pakket httr voor HTTP-verzoeken en jsonlite voor het lezen van JSON-data.
• JavaScript: Met fetch of axios kun je API’s aanroepen vanuit webapplicaties of Node.js-scripts.
• curl: Een command-line tool die handig is voor snelle tests. Typ bijvoorbeeld curl https://api.zenodo.org/records?q=climate in je terminal en je ziet meteen wat eruit komt.

Let op deze valkuilen

API’s zijn krachtig, maar er zijn een paar dingen waar je op moet letten:

• Rate limiting: Veel API’s limiteren hoe vaak je mag aanroepen per minuur of uur. Zenodo staat bijvoorbeeld 100 verzoeken per uur toe zonder authenticatie. Houd daar rekening mee in je code.
• Authenticatie: Sommige API’s vragen om een API-sleutel, vooral als je data wilt uploaden of gevoelige datasets wilt openen. Die kun je meestal aanvragen via je account op de repository.
• Documentatie: Niet alle API-documentatie is even duidelijk. Begin altijd met het lezen van de officiële docs — en test kleine stukjes code voordat je grotere scripts bouwt.
• Wijzigingen: API’s kunnen veranderen. Een endpoint die vandaag werkt, kan morgen anders heten. Houd de changelog in de gaten.

Best practices: zo werk je slim met API’s

Om het meeste uit API-toegang te halen, houd je aan deze tips:

• Begin klein: test eerst met één simpel verzoek voordat je complexe queries bouwt.
• Gebruik bestaande bibliotheken: die handelen fouten en authenticatie al voor je af.
• Voeg wachtlogica toe: als je tegen rate limiting aanloop, wacht je even in plaats van te crashen.
• Cache resultaten: als je dezelfde data vaker nodig hebt, sla het dan lokaal op in plaats van steeds opnieuw op te halen.
• Documenteer je code: zodat jij én anderen later begrijpen wat er gebeurt.

Conclusie: API-toegang maakt je onderzoek slimmer

API-toegang is geen luxe meer — het is een must voor onderzoekers die efficiënt willen werken met data. Of je nu werkt met klimaatmodellen, genoomdata of sociale wetenschappen, repositories zoals Zenodo, Figshare en Dataverse bieden krachtige API’s om precies de data te halen die jij nodig hebt.

En met tools als Python of R hoef je geen informaticus te zijn om ermee te beginnen. Dus: stop met klikken, start met coderen. Je onderzoek wordt er sneller, schoner en schaalbaarder van. En dat past perfect bij de principes van Open Science.