API
Bedrijfsdata in je eigen systemen
Dezelfde 3,6 miljoen bedrijven als in het portaal, via een REST API met JSON. Zoeken is gratis, contacten onthullen kost 1 credit per bedrijf, en wat je organisatie al heeft onthuld blijft gratis.
Endpoints
Vijf endpoints, één datamodel
Basis-URL https://api.bizstackdata.com. Authenticatie met een bearer-sleutel uit het portaal.
-
GET
/v1/companies/searchZoek op naam, SBI, provincie, plaats, postcode, grootte, rechtsvorm, oprichtingsjaar en beschikbare contactvelden.
Kosten: Gratis -
GET
/v1/companies/{registration_number}Het profiel van één bedrijf op KVK-nummer.
Kosten: Gratis -
POST
/v1/companies/contactsE-mail, telefoon, website en contactpersoon voor een lijst KVK-nummers.
Kosten: 1 credit per bedrijf -
GET
/v1/usageJe tegoed in de huidige periode, verdeeld over portaal en API.
Kosten: Gratis -
GET
/v1/openapi.jsonDe volledige specificatie als OpenAPI 3.1-document, zonder sleutel.
Kosten: Openbaar
Voorbeeld
Zoeken in cURL, JavaScript of Python
Bakkerijen in Utrecht met een bekend e-mailadres. De response bevat geen contactwaarden, alleen of ze beschikbaar zijn.
curl --request GET \
--url 'https://api.bizstackdata.com/v1/companies/search?sbi=1071&province=Utrecht&has=email&limit=25' \
--header 'Authorization: Bearer YOUR_API_KEY'
const res = await fetch('https://api.bizstackdata.com/v1/companies/search?sbi=1071&province=Utrecht&has=email&limit=25', {
headers: { Authorization: `Bearer ${process.env.BZD_API_KEY}` },
});
const { data, meta } = await res.json();
import os, requests
res = requests.get(
'https://api.bizstackdata.com/v1/companies/search?sbi=1071&province=Utrecht&has=email&limit=25',
headers={'Authorization': f"Bearer {os.environ['BZD_API_KEY']}"},
)
print(res.json()['data'])
{
"data": [
{
"registration_number": "34512879",
"legal_name": "Bakkerij Voorbeeld B.V.",
"employees": "2-10",
"address": { "city": "Utrecht", "province": "Utrecht" },
"availability": { "email": true, "phone": false, "website": true, "contact_person": false }
}
],
"meta": { "count": 1, "total": 34, "credits_charged": 0 }
}
Details
Gebouwd voor productie
-
API-sleutels
Live- en testsleutels per organisatie, aan te maken en in te trekken in het portaal. We bewaren alleen een hash.
-
Rate limits
600 verzoeken per minuut per sleutel. Overschrijding geeft 429 met een duidelijke foutcode.
-
Request logs
Elke aanroep staat met request_id, status en verbruikte credits in het portaal.
-
Sandbox
bzd_test_-sleutels geven voorbeelddata in hetzelfde formaat en kosten nooit credits.
Documentatie
De volledige referentie met parameters, foutcodes en voorbeelden staat in het portaal. De OpenAPI-specificatie is openbaar.