Recherche par adresse

Recherche des entreprises localisées à une adresse spécifique en utilisant le code postal, le nom de rue et optionnellement le numéro de maison. Les résultats sont paginés avec 20 résultats par page.

GET

/api/companies/address

Headers

Header	Value	Description
`X-API-Key`	`pk_live_...`	Clé API (obligatoire)

Paramètres

Name	Type	Description
`postalCode` requis	`string`	Code postal belge (4 chiffres, format: /^\d{4}$/)Exemple: `1080`
`street` requis	`string`	Nom de la rue (sera automatiquement converti en majuscules)Exemple: `RUE DE LA COLONNE`
`houseNumber` optionnel	`string`	Numéro de maison (peut inclure des lettres comme 1A, 12B)Exemple: `1A`
`page` optionnel	`integer`	Numéro de page (20 résultats par page)Exemple: `1`Défaut: `1`

Exemple de requête

cURL

curl -X GET \
  "https://companybelgium.be/api/companies/address?postalCode=1080&street=RUE+DE+LA+COLONNE&houseNumber=1A" \
  -H "X-API-Key: pk_live_votre_cle"

JavaScript / Node.js

const params = new URLSearchParams({
  postalCode: '1080',
  street: 'RUE DE LA COLONNE',
  houseNumber: '1A',
});

const response = await fetch(
  `https://companybelgium.be/api/companies/address?${params}`,
  {
    headers: { 'X-API-Key': process.env.API_KEY },
  }
);

const data = await response.json();
console.log(`${data.meta.totalResults} entreprises à cette adresse`);

Python

import requests

response = requests.get(
    'https://companybelgium.be/api/companies/address',
    params={
        'postalCode': '1080',
        'street': 'RUE DE LA COLONNE',
        'houseNumber': '1A'
    },
    headers={'X-API-Key': 'pk_live_votre_cle'}
)
data = response.json()

for company in data['data']['results']:
    print(f"{company['name']} - {company['address']}")

Exemple de réponse

200 OK

{
  "success": true,
  "data": {
    "results": [
      {
        "enterpriseNumber": "0631.880.764",
        "name": "25 RUE DE LA GLACIERE",
        "status": "Actif",
        "type": "ENT PM",
        "address": "Rue de la Colonne 1A, 1080 Molenbeek-Saint-Jean"
      },
      {
        "enterpriseNumber": "0780.749.436",
        "name": "A & R Beaute",
        "status": "Actif",
        "type": "ENT PM",
        "address": "Rue de la Colonne 1A, 1080 Molenbeek-Saint-Jean"
      }
    ],
    "totalResults": 440,
    "currentPage": 1,
    "totalPages": 22
  },
  "timestamp": "2026-02-11T12:00:00.000Z",
  "meta": {
    "totalResults": 440,
    "currentPage": 1,
    "totalPages": 22,
    "responseTime": 1250
  }
}

Codes d'erreur

400 Bad Request

Code postal ou rue manquant/invalide

400 Bad Request

{
  "success": false,
  "error": "postalCode (4 digits) and street are required",
  "timestamp": "2026-02-11T12:00:00.000Z"
}

Mise en cache

Durée du cache: 10 minutes (stale-while-revalidate: 20 minutes)

Notes

Le code postal doit être exactement 4 chiffres.
Le nom de rue est automatiquement converti en majuscules.
Le numéro de maison est optionnel et peut contenir des lettres (ex: 1A, 12B).

Page précédente

Recherche d'entreprises

Page suivante

Détails d'une entreprise

Besoin d'aide ?

Notre equipe de support est disponible pour vous aider avec l'integration de l'API.