API BCE búsqueda por dirección: encontrar empresas belgas
Búsqueda por dirección con API BCE: encuentra las empresas belgas domiciliadas en una dirección (código postal, calle, número), con su estado.
Endpoints del recurso Búsqueda. Todas las llamadas requieren autenticación y devuelven el envelope JSON estándar.
URL base: https://companybelgium.be/api/v2 · Autenticación
Search enterprises by postal address#
Find enterprises registered at a given Belgian address. Street is matched partially (FR or NL); results are paginated.
Parámetros
| Nombre | En/Tipo | Requerido | Descripción |
|---|---|---|---|
postalCode | query string | Requerido | 4-digit Belgian postal code, e.g. 1000. |
street | query string | Requerido | Street name (partial match, FR or NL). |
houseNumber | query string | opcional | Exact house number. |
page | query integer | opcional | 1-based page number (20 results per page). |
pageSize | query integer | opcional | Results per page (default 20, max 100). Alias: limit. |
Solicitud
curl https://companybelgium.be/api/v2/search/address \
-H "X-API-Key: $API_BCE_KEY" \
-H "X-API-Secret: $API_BCE_SECRET"Respuesta
{
"success": true,
"data": {
"results": [
{
"enterpriseNumber": "1033.022.383",
"name": "ESPERO-SOFT INFORMATIQUES",
"status": "AC",
"statusCode": "AC",
"juridicalSituationCode": "...",
"type": "PM",
"address": "Rue de la Colonne 1A, 1080 Molenbeek-Saint-Jean",
"startDate": "..."
}
],
"totalResults": "...",
"currentPage": 1,
"totalPages": "...",
"searchParams": {
"zipCode": "1080"
}
},
"timestamp": "...",
"meta": {
"responseTime": "..."
}
}▶ Probar esta solicitud
Casos de uso de la búsqueda por dirección con API BCE#
La búsqueda por dirección responde a una pregunta concreta: ¿qué empresas están domiciliadas aquí? Es útil en varios procesos. Por ejemplo, un equipo antifraude detecta muchas empresas registradas en la misma dirección. Del mismo modo, un comercial prospecta las empresas de una calle o de un parque empresarial. También sirve para encontrar el número BCE de un cliente cuando solo conoces su dirección.
Cada resultado incluye el número, el nombre, el estado, el tipo y la fecha de inicio. Por tanto, puedes descartar las empresas cesadas sin otra llamada.
Buenas prácticas#
- Envía siempre el código postal de 4 cifras y una parte del nombre de la calle.
- Escribe la calle en francés o en neerlandés: ambas formas coinciden.
- Añade
houseNumbersolo si lo conoces con exactitud. - Ajusta
pageSize(20 por defecto, 100 como máximo) a tu uso. - Detén la paginación cuando
currentPagealcanzatotalPages.
Errores frecuentes#
El error más común es enviar la dirección completa en un solo campo. La API espera el código postal, la calle y el número por separado. Por eso conviene descomponer la dirección en tu formulario. Otro error es incluir el tipo de vía con una ortografía distinta. Como la calle se compara de forma parcial, un fragmento más corto suele dar mejores resultados. Además, recuerda que el número de casa reduce mucho los resultados.
Ejemplo: detectar domiciliaciones masivas
Un equipo de cumplimiento puede usar la búsqueda para señalar direcciones con muchas empresas. Primero, toma la dirección de un cliente nuevo. Luego consulta /search/address con el código postal, la calle y el número. Si totalResults es alto, la dirección puede ser un centro de domiciliación. No es un indicio de fraude por sí solo. Sin embargo, justifica una revisión manual del expediente. Además, el estado de cada resultado muestra cuántas empresas siguen activas allí. Por último, guarda el resultado con la fecha de la búsqueda. Así puedes justificar cada decisión ante un auditor.
Preguntas frecuentes sobre API BCE y la búsqueda por dirección#
¿La búsqueda devuelve los establecimientos?
Encuentra las empresas registradas en una dirección belga. Para las unidades de una empresa, consulta después sus establecimientos.
¿Puedo buscar fuera de Bélgica con API BCE?
No. El código postal es belga, de 4 cifras, y la búsqueda cubre las empresas registradas en la BCE.
¿Cuántas solicitudes consume una búsqueda?
Cada página es una solicitud. Una búsqueda con tres páginas de resultados exige, por tanto, tres llamadas.