KVK API gratis: kies de juiste route voor je koppeling

Welke KVK API kun je gratis gebruiken?

Een KVK API gratis gebruiken kan voor een technische test of voor bepaalde open bedrijfsgegevens. De testomgeving werkt met fictieve bedrijven. De open dataset Basis Bedrijfsgegevens geeft een beperkte set gegevens over bv's en nv's. Welke route past, hangt af van wat je koppeling moet opleveren: een werkende integratie, gegevens bij bekende KVK-nummers of een selectie van bedrijven.

Begin daarom met de uitvoer die je nodig hebt. Wil je weten of je software een antwoord goed verwerkt? Dan kun je met testdata aan de slag. Heb je al KVK-nummers en wil je daarbij open gegevens lezen? Bekijk dan de open dataset. Wil je bedrijven vinden voor een lijst op sector en plaats, bekijk dan eerst de selecties in FirmTrove. Je kunt zo'n selectie met een gratis account beoordelen voordat je een eigen koppeling bouwt.

Probeer je koppeling eerst in de testomgeving

KVK biedt een gratis testomgeving met een vaste verzameling fictieve bedrijven. Er zijn aparte testadressen voor Zoeken, Basisprofiel, Vestigingsprofiel en Naamgeving. Op de documentatiepagina staan de beschikbare testgevallen en de instructies voor authenticatie.

Gebruik die omgeving om je invoer en verwerking uit te werken. Maak bijvoorbeeld eerst een zoekactie op naam en laat je programma het gevonden KVK-nummer bewaren. Controleer daarna of je scherm een leeg antwoord begrijpelijk toont. Neem een foutgeval uit de documentatie mee. Daarmee ontdek je fouten in de koppeling voordat je er echte klantgegevens doorheen stuurt.

Schrijf bij elke test op wat je wilt zien. Een antwoord dat technisch aankomt, kan voor je toepassing nog onbruikbaar zijn. Denk aan een ontbrekend veld waar je export een vaste kolom verwacht. Laat je software zo'n waarde leeg bewaren en zichtbaar onderscheiden van een ingevuld gegeven. De test is klaar wanneer je ook begrijpt wat er bij een onverwacht antwoord gebeurt.

Heb je KVK-nummers? Bekijk de open dataset

De open dataset Basis Bedrijfsgegevens wordt per KVK-nummer bevraagd en bevat gegevens over bv's en nv's. Voorbeelden zijn de startdatum, rechtsvorm, activiteiten en het regiodeel van de postcode. Per IP-adres is maximaal één bevraging per minuut toegestaan. Daarnaast geldt een algemene limiet van 200 bevragingen per vijf minuten. De gebruiksvoorwaarden staan in de documentatie van KVK.

Voor een technische proef kun je beginnen met een kleine set nummers die je al gebruikt. Bepaal vooraf welke velden je wilt opslaan en welk scherm ze gaat tonen. Vraag alleen informatie op die je toepassing daadwerkelijk gebruikt. Bewaar bij de uitkomst ook welke bron je hebt geraadpleegd, zodat een collega later kan terugvinden waar het gegeven vandaan kwam.

Een dataset kan goed passen bij een analyse en toch een andere uitvoer geven dan je voor een bedrijvenlijst nodig hebt. Leg daarom je gewenste kolommen naast de veldbeschrijving van KVK. Controleer die aansluiting voordat je veel tijd in de koppeling steekt. Voor een officiële controle gebruik je de daarvoor bedoelde KVK-producten en hun voorwaarden.

Wat als je bedrijven wilt zoeken en selecteren?

Een koppeling die gegevens bij een bekend nummer ophaalt, begint op een ander punt dan een onderzoek naar een doelgroep. Bij dat onderzoek moet je eerst bepalen welke bedrijven je wilt bekijken. In FirmTrove kun je daarvoor zoeken en filteren en daarna een selectie als CSV exporteren. De REST- en MCP-ingangen sluiten aan op hetzelfde product.

FirmTrove Gratis geeft volgens de prijspagina 100 rijen per kalendermaand, met maximaal 100 rijen per export. CSV, REST en MCP delen dit tegoed. Zoeken en filteren verbruiken geen rijen. Je kunt een account aanmaken zonder betaalkaart. Kies voor je proef één afgebakende selectie, zodat je de uitvoer rustig kunt vergelijken met wat je nodig hebt.

Wil je bijvoorbeeld installatiebedrijven in een bepaalde plaats onderzoeken, werk dan eerst je selectie uit in de zoeker. Open een paar records en bekijk of de informatie bij je vraag past. Exporteer daarna een kleine selectie. Pas wanneer je weet welke velden je gebruikt, heeft het zin om dezelfde taak in je eigen software onder te brengen.

Houd tijdens die proef rekening met het gedeelde tegoed. Als je via CSV rijen exporteert en daarna een koppeling gebruikt, werk je binnen hetzelfde maandtegoed. Maak daarom vooraf een korte beschrijving van je proef: welke selectie, welke uitvoer en waarom je die nodig hebt. Zo kun je ook een maand later nog beoordelen of de koppeling het gewenste werk heeft opgeleverd.

Welke uitvoer moet je FirmTrove-koppeling verwerken?

In de REST-documentatie staat GET /api/companies als ingang voor een zoekactie. De parameter q zoekt in naam en plaats en vraagt minimaal 3 tekens. De sector is een apart filter. Dat onderscheid telt wanneer je een bestaande selectie omzet naar software: een woord in de bedrijfsnaam en een sectorselectie beschrijven verschillende zoekvragen.

Het antwoord bevat de gevonden records in items, samen met informatie over de pagina en de volgende stap. Met de parameter limit vraag je maximaal 50 records per pagina op. De documentatie beschrijft ook het veld withheld bij een record. Neem die uitleg door voordat je de uitvoer in een vaste tabel zet. Zo kan je toepassing het verschil bewaren tussen een geleverd gegeven en een veld waarvoor de uitvoer een reden vermeldt.

Werk vanuit de actuele API- en MCP-documentatie en vergelijk de eerste uitvoer met de selectie in de browser. Je hoeft daarvoor geen complete import te bouwen. Controleer eerst of je zoekvraag goed is overgenomen, daarna of je de ontvangen velden juist verwerkt. Die kleine proef geeft je een concreet besluit over het verdere gebruik.

Controleer de herkomst van de velden die je gaat gebruiken

Een naam of website in een bedrijvenbestand is pas goed te beoordelen wanneer de herkomst terug te vinden is. De bronnenpagina van FirmTrove beschrijft hoe open datasets en bedrijfswebsites naast elkaar worden gebruikt. De bron verschilt per soort gegeven. Een cijfer uit een open dataset en een citaat van een bedrijfswebsite vragen daarom elk om hun eigen controle.

Neem die herkomst mee in je proef. Open bij een gegeven de bronverwijzing en kijk welk feit daar werkelijk staat. Bepaal vervolgens of dat feit bruikbaar is voor de taak die je voor ogen hebt. Een gevonden gegeven wordt daarmee iets dat je kunt onderbouwen, in plaats van een ingevulde cel waarvan later niemand meer weet waarom die in de lijst staat.

Op de methodepagina lees je hoe FirmTrove waarnemingen en datums uitlegt. Gebruik die uitleg wanneer je gegevens vergelijkt. Schrijf bijvoorbeeld bij een verschil tussen twee bronnen eerst op welk soort datum je ziet. Dat voorkomt dat je een recente ophaling verwart met een recent ontstane gebeurtenis.

Veelgestelde vragen

Kan ik zonder betaald abonnement een koppeling testen?

Ja. Gebruik daarvoor de testomgeving van KVK en volg de instructies op de documentatiepagina. Die omgeving bevat fictieve bedrijven en is bedoeld om API-gedrag te proberen. Maak voor je eigen toepassing een testplan, zodat je naast het normale antwoord ook ontbrekende waarden en foutafhandeling controleert.

Welke route kies ik voor een gratis bedrijvenlijst?

Begin met de vraag welke bedrijven en welke kolommen je nodig hebt. In FirmTrove kun je gratis zoeken en filteren en met het Gratis-account een kleine selectie exporteren binnen het maandtegoed. Bekijk de selectie eerst in het product. Voor gegevens uit een officiële KVK-bron raadpleeg je het passende KVK-product.

Waar vind ik de kosten van de betaalde KVK API?

In onze gids over KVK API kosten lees je hoe je de betaalde toegang en profielaanvragen beoordeelt. Deze pagina helpt je de gratis beginroute kiezen. Controleer de actuele tarieven bij KVK voordat je een betaald product aanvraagt en baseer je berekening op je eigen gebruik.