API-documentatie
De BusinessRadar REST API geeft programmatische toegang tot Belgische bedrijfsdata. Beschikbaar vanaf het Team-plan. Alle responses zijn JSON.
Authenticatie
Maak een API-sleutel aan op je organisatiepagina (organisatiebeheerder, Team-plan of hoger). Stuur de sleutel mee als Bearer-token:
Authorization: Bearer brk_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxx
Basis-URL: https://portal.businessradar.be/api/v1 · Rate limit: 120 verzoeken/minuut per sleutel.
Endpoints
/searchZoek ondernemingen. Parameters: q (zoekterm), nace (NACE-code), naceGroup (2-cijfer prefix), zip (postcode), status (active·stopped·all), revenueMin/revenueMax, sort (revenue·name·founded), page.
curl "https://portal.businessradar.be/api/v1/search?q=colruyt&status=active" \ -H "Authorization: Bearer $BR_API_KEY"
{
"page": 1, "page_size": 25, "total": 3,
"results": [
{ "kbo": "0400378485", "name": "Colruyt Group NV",
"municipality": "Halle", "zipcode": "1500",
"nace_code": "47110", "nace_label": "Supermarkten",
"active": true, "revenue": null, "fte": null }
]
}/company/{kbo}Volledige fiche van één onderneming op KBO-nummer (10 cijfers, punten mogen). Financiële kerncijfers en bestuurders zijn inbegrepen bij plannen met die functie.
curl "https://portal.businessradar.be/api/v1/company/0400378485" \ -H "Authorization: Bearer $BR_API_KEY"
{
"kbo": "0400378485",
"name": "Colruyt Group NV",
"active": true,
"juridical_form": "017",
"addresses": [ ... ],
"activities": [ ... ],
"key_figures": [ ... ] // enkel bij Pro+ functies
}/market-context/{zip}Marktcontext rond een postcode: demografie (Statbel), top-sectoren op bedrijvendichtheid (KBO) en retail/horeca POI (OpenStreetMap). Enterprise-functie.
curl "https://portal.businessradar.be/api/v1/market-context/9000" \ -H "Authorization: Bearer $BR_API_KEY"
{
"zipcode": "9000",
"demographics": { "municipality": "Gent", "province": "Provincie Oost-Vlaanderen",
"population": 274042, "average_age": 39.6 },
"top_sectors": [ { "nace2": "70", "active_companies": 1085, "sector": "..." } ],
"poi": { "retail": 1244, "horeca": 997 }
}Foutcodes
| 200 | OK |
| 401 | Ontbrekende of ongeldige API-sleutel |
| 403 | Plan zonder API-toegang of organisatie geschorst |
| 404 | Onderneming niet gevonden |
| 429 | Rate limit overschreden |
| 500 | Interne fout |