Documentación / Búsqueda

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#

GET/search/address

Find enterprises registered at a given Belgian address. Street is matched partially (FR or NL); results are paginated.

Parámetros

NombreEn/TipoRequeridoDescripción
postalCodequery stringRequerido4-digit Belgian postal code, e.g. 1000.
streetquery stringRequeridoStreet name (partial match, FR or NL).
houseNumberquery stringopcionalExact house number.
pagequery integeropcional1-based page number (20 results per page).
pageSizequery integeropcionalResults 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

Las solicitudes de demo pasan por api-bce.be con una clave compartida: 15 solicitudes cada 10 minutos, solo datos públicos del registro.

GET /search/address
cURL
curl "" \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

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 houseNumber solo si lo conoces con exactitud.
  • Ajusta pageSize (20 por defecto, 100 como máximo) a tu uso.
  • Detén la paginación cuando currentPage alcanza totalPages.

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.