Companyweb APIcompanyweb.be ↗
Search Belgian companies and retrieve details including establishment year, principal activity, employee count, and legal form via the Companyweb.be API.
What is the Companyweb API?
The Companyweb.be API provides 2 endpoints for accessing Belgian company data sourced from companyweb.be. Use search_company to find companies by name and retrieve their enterprise number, legal form, and address, then call get_company_details with an enterprise ID to pull 10 structured fields including establishment date, FTE employee count, company size category, VAT liability status, and principal business activity.
curl -X GET 'https://api.parse.bot/scraper/f6a4a6b1-dd75-42fb-b5de-e9065edce4d4/search_company?query=Proximus' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for Belgian companies by name. Returns a list of matching companies with their enterprise number, legal form, address, and location. Results are not paginated; the site returns all matches for the query.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Company name or search term to find matching Belgian companies. |
{
"type": "object",
"fields": {
"total": "integer total number of results returned",
"results": "array of company objects with enterprise_number, enterprise_id, name, legal_form, address, location"
},
"sample": {
"data": {
"total": 147,
"results": [
{
"name": "Proximus",
"address": "Koning Albert Ii-Laan",
"location": "Schaarbeek",
"legal_form": "NV",
"enterprise_id": "0202239951",
"enterprise_number": "BE 0202.239.951"
},
{
"name": "Proximus Art",
"address": "Koning Albert Ii-Laan",
"location": "Schaarbeek",
"legal_form": "VZW",
"enterprise_id": "0458922341",
"enterprise_number": "BE 0458.922.341"
}
]
},
"status": "success"
}
}About the Companyweb API
Endpoints and What They Return
The search_company endpoint accepts a query string — a company name or partial name — and returns a list of matching Belgian companies. Each result includes the enterprise_number, enterprise_id, name, legal_form, address, and location. Results are not paginated; all matches for the query are returned in a single response alongside a total count. The enterprise_id from these results is the key input for the second endpoint.
Company Detail Lookup
The get_company_details endpoint takes an enterprise_id (the numeric part of a Belgian enterprise number, 7–10 digits) and returns a full profile for that company. Returned fields include name, status (e.g. Active), full address, legal_form with abbreviation, vat_liable status, established date in DD-MM-YYYY format, company_size category (Small, Medium-sized, Big), employees_fte (or null if unavailable), the formatted enterprise_number (e.g. BE 0202.239.951), and principal_activity.
Coverage and Scope
All data covers Belgian registered companies as listed on companyweb.be. The enterprise number format follows the Belgian Crossroads Bank for Enterprises (CBE) convention. The employees_fte field may be null for companies that do not publicly report headcount figures. There is no pagination on search results — queries that match a large number of companies return the full set in one call.
The Companyweb API is a managed, monitored endpoint for companyweb.be — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when companyweb.be changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official companyweb.be API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Belgian business directory by searching companies by name and storing their enterprise numbers and addresses.
- Enrich a CRM with Belgian company profiles including legal form, company size, and establishment year.
- Screen potential partners by checking a company's
status(active vs. inactive) andvat_liablefield before engagement. - Analyse the distribution of
company_sizecategories across a sector usingprincipal_activitydata from bulk lookups. - Verify a supplier's official
enterprise_numberand registeredaddressagainst their self-reported details. - Track employee headcount trends over time by periodically fetching
employees_ftefor a list of target companies. - Populate a lead generation tool with structured Belgian company data including legal form and founding date.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Companyweb.be have an official developer API?+
What does search_company return, and can I filter results by location or legal form?+
search_company endpoint returns all matching companies for the name query as a single unfiltered list. Each result includes legal_form, address, and location, so you can filter client-side by those fields, but the endpoint itself only accepts a query string — there are no server-side filter parameters for location, legal form, or company size.Is the employees_fte field always populated?+
employees_fte field returns null when a company has not publicly disclosed headcount data on companyweb.be. This is common for smaller or recently established companies. The company_size string field (Small, Medium-sized, Big) is generally available even when FTE figures are absent.Does the API return financial data such as revenue, turnover, or balance sheet figures?+
Can I look up companies by VAT number or enterprise number directly, without searching by name first?+
get_company_details endpoint accepts an enterprise_id directly if you already have it, so a name search is not required when you know the identifier. However, there is no dedicated endpoint for reverse lookup by VAT number or formatted BE enterprise number. You can fork this API on Parse and revise it to add that lookup path.