API-documentatie | Taxon Vastgoeddata-API voor België

Snel starten

In drie stappen ben je klaar om de Taxon API te gebruiken.

1

API-sleutel aanvragen

Stuur een e-mail naar info@taxon.be met je bedrijfsnaam en gebruiksdoel. Je ontvangt binnen 24 uur een API-sleutel.

2

Authenticatie instellen

Voeg je API-sleutel toe als Bearer token in de Authorization header van elke request.

3

Eerste API-call

Maak je eerste request naar een endpoint. Bekijk de voorbeelden hieronder om direct aan de slag te gaan.

cURL voorbeeld

# Eerste API-call: vastgoedwaardering opvragen
curl -X POST https://api.taxon.be/api/calculate-valuation \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "Dikkebusseweg 43, 8900 Ieper",
    "property_type": "house",
    "living_area": 170
  }'

Authenticatie

De Taxon API gebruikt Bearer token authenticatie. Elke API-request moet een geldige API-sleutel bevatten in de Authorization header. Zonder geldige sleutel ontvang je een 401 Unauthorized fout.

Vereiste headers bij elke request

Authorization: Bearer sk-your-api-key
Content-Type: application/json

Beveiligingstip

Bewaar je API-sleutel veilig en deel deze nooit in client-side code, publieke repositories of onbeveiligde omgevingen. Gebruik altijd server-side calls.

Endpoints overzicht

Alle endpoints zijn beschikbaar via https://api.taxon.be. Hieronder een overzicht van alle beschikbare endpoints.

Endpoint	Methode	Beschrijving
/api/calculate-valuation	POST	Vastgoedwaardering berekenen
/api/referentiepunten/search	GET	Vergelijkbare panden zoeken
/api/fotos/search	GET	Pandfoto's ophalen
/api/reconstruct	GET	3D model reconstructie
/api/search	GET	Adres autocomplete

Valuatie API

POST

Bereken een geautomatiseerde vastgoedwaardering voor een adres in België. Het model analyseert referentiepunten, EPC-data en markttrends om een nauwkeurige waardeschatting te genereren.

POST /api/calculate-valuation

Request body

JSON request

{
  "address": "Dikkebusseweg 43, 8900 Ieper",
  "property_type": "house",
  "living_area": 170,
  "construction_year": 1945,
  "epc_label": "C",
  "bedrooms": 3,
  "plot_area": 298
}

Parameters

Parameter	Type	Verplicht	Beschrijving
address	string	Ja	Volledig adres inclusief postcode en gemeente
property_type	string	Ja	`house`, `apartment`, `villa`, `studio`
living_area	number	Nee	Bewoonbare oppervlakte in m²
construction_year	number	Nee	Bouwjaar van het pand
epc_label	string	Nee	EPC-label: `A+`, `A`, `B`, `C`, `D`, `E`, `F`
bedrooms	number	Nee	Aantal slaapkamers
plot_area	number	Nee	Perceeloppervlakte in m²

Response

200 OK

JSON response

{
  "estimated_sales_value": 377849,
  "estimated_rental_value": 884,
  "confidence_interval_sales": [332161, 423537],
  "sales_reference_count": 11,
  "model_version": "v1"
}

Response velden

Veld	Type	Beschrijving
estimated_sales_value	number	Geschatte verkoopwaarde in euro
estimated_rental_value	number	Geschatte maandelijkse huurwaarde in euro
confidence_interval_sales	array	Betrouwbaarheidsinterval [minimum, maximum] voor de verkoopwaarde
sales_reference_count	number	Aantal referentiepunten gebruikt voor de schatting
model_version	string	Versie van het valuatiemodel

Referentiepunten API

GET

Zoek vergelijkbare verkochte panden in de buurt van een adres. Ideaal voor marktanalyse en onderbouwing van taxatierapporten.

GET /api/referentiepunten/search?address=...&radius=500&limit=20

Query parameters

Parameter	Type	Verplicht	Beschrijving
address	string	Ja	Adres als zoekcentrum
radius	number	Nee	Zoekradius in meter (standaard: 500, max: 5000)
limit	number	Nee	Max aantal resultaten (standaard: 20, max: 100)
type	string	Nee	Filter op pandtype: `house`, `apartment`
min_price	number	Nee	Minimum verkoopprijs in euro
max_price	number	Nee	Maximum verkoopprijs in euro
epc	string	Nee	Filter op EPC-label (bv. `A,B,C`)

Response voorbeeld

200 OK

JSON response

{
  "count": 15,
  "results": [
    {
      "address": "Rijselstraat 12, 8900 Ieper",
      "price": 345000,
      "date": "2025-11-15",
      "type": "house",
      "living_area": 155,
      "epc_label": "C",
      "distance_m": 230,
      "lat": 50.8503,
      "lng": 2.8825
    }
    // ... meer resultaten
  ]
}

Foutcodes

De API retourneert standaard HTTP-statuscodes. Bij een fout bevat de response een JSON-object met een error veld.

200

OK

Request is succesvol verwerkt. De response bevat de gevraagde data.

400

Bad Request

De request bevat ongeldige of ontbrekende parameters. Controleer de request body en query parameters.

401

Unauthorized

Geen of ongeldige API-sleutel meegegeven. Controleer je Authorization header.

404

Not Found

Het gevraagde endpoint of adres is niet gevonden. Controleer de URL en parameters.

429

Rate Limited

Je hebt het maximaal aantal requests per minuut bereikt. Wacht even en probeer het opnieuw. Zie rate limiting.

500

Server Error

Interne serverfout. Probeer het later opnieuw. Als het probleem aanhoudt, neem contact op via info@taxon.be.

401 Unauthorized

Fout response voorbeeld

{
  "error": "Unauthorized",
  "message": "Ongeldige of ontbrekende API-sleutel."
}

Rate limiting

Om de stabiliteit van de API te garanderen, gelden er limieten op het aantal requests per minuut.

Standaard limiet

100 req/min

Standaard voor alle API-sleutels.

Hogere limieten

Op aanvraag

Neem contact op voor hogere limieten op maat van je project.

Response headers

Elke response bevat X-RateLimit-Remaining en X-RateLimit-Reset headers, zodat je je verbruik kunt monitoren.

API Documentatie