Overstappen van Matrixian

Gebaseerd op de openbare documentatie van Matrixian, oktober 2026.

Werk je met Claude Code? De skill migrate-from-matrixian zet je code over met deze tabellen; zie de Claude Code-plugin.

Endpoints

Matrixian	Wat	Huispedia
`GET /homevalue`, `GET /homevalue/value`	Woningwaarde	`GET /v5/properties/{locator}/valuation`
`GET /homevalue` met eigen kenmerken	Woningwaarde met eigen invoer	`POST /v5/valuations/scenarios`
`GET /homevalue?nReferences=`	Woningwaarde met referenties	`GET /v5/properties/{locator}/valuation/plus` (contract) Met de vijf beste referentiewoningen.
`GET /leadtool`	Waardebandbreedte	`GET /v5/properties/{locator}/valuation` De bandbreedte is `lower` tot `upper`.
`GET /mx-reference-finder`	Referentiewoningen	`GET /v5/properties/{locator}/references` (contract)
`GET /mx-transaction-finder`	Koopsom	`GET /v5/properties/{locator}/transactions` (contract)
`GET /woz-value`, `GET /woz-value/live`	WOZ-waarde	`GET /v5/properties/{locator}/woz`
`GET /mx-house-details`	Woningkenmerken	`GET /v5/properties/{locator}` `GET /v5/properties/{locator}/energy-label`
`GET /bag-data`	BAG-gegevens	`GET /v5/addresses/{locator}` `GET /v5/buildings/{bag_pand_id}`
`GET /buurtinfo`	Buurtinformatie	`GET /v5/areas/{area}/demographics` `GET /v5/areas/{area}/stats` `GET /v5/areas/{area}`

Transacties, referentiewoningen en Woningwaarde+ krijg je met een contract: [email protected].

Authenticatie

	Matrixian	Huispedia
Sleutel	`Authorization: Bearer <api-key>`	`Authorization: Bearer hp_…` of `X-API-Key: hp_…`
Basis-URL	`https://api.matrixian.com/v1`	`https://huispedia.dev/v5`
Methode	`GET` met query-parameters	`GET` met de woning in het pad; `POST` alleen voor scenario's
Antwoord	`{id, params, data, error, meta, status}`	De gegevens bovenaan; `meta` met `request_id` en `credits`

Adressen en gebieden

Matrixian	Huispedia	Opmerking
`postalCode` + `houseNumber` + `houseLetter` + `houseNumberExt`	`1076LJ-12-2`	Postcode, huisnummer en toevoeging met streepjes in het pad; letter en toevoeging staan samen in het laatste deel.
`houseLetter`, `houseNumberExt`	`house_number_ext`	Twijfel je: `GET /v5/addresses/1076LJ-12?all=true` geeft elke woning met haar `house_number_ext`.
`bagId`, `bagNumberId` (nummeraanduiding)	`bag:0363200000028422`
`bagObjectId`, `bagBuildingId`	`bag_verblijfsobject_id`, `bag_pand_id`	In `GET /v5/addresses/{locator}`; een pand vraag je op met `GET /v5/buildings/{bag_pand_id}`.
`valuationDate` (`2026-09-01`)	`as_of_date` (`2026-09-01`)
`buurtCode` (`BU04170328`)	`neighbourhood:BU04170328`	Een gebied is `niveau:code`; `GET /v5/areas/lookup?postcode=1076LJ` geeft de codes.

Meer in Adressen en gebieden.

Velden

Woningwaarde

GET /homevalue → GET /v5/properties/{locator}/valuation

Matrixian	Huispedia	Opmerking
`postalCode`, `houseNumber`, `houseLetter`, `houseNumberExt`	`{locator}`
`valuationDate`	`?as_of_date=`	Tot zes maanden terug; verder terug met de waardehistorie.
`data.predictedValue`, `data.weightedValue`	`valuation.value`
`data.valueDate`	`valuation.as_of_date`
`data.accuracy`	`confidence.score_pct`	Hier de kans dat de waarde binnen 10% van een koopsom ligt.
`data.confidenceClass`	`confidence.class`	Daar 0 tot 5; hier `high`, `medium` of `low`.
`data.weightedValueRange` (Leadtool)	`valuation.lower`, `valuation.upper`, `valuation.interval`	Twee getallen met hun zekerheid (80%).
`data.bagId`, `postalCode`, `houseNumber`, `houseNumberExt`, `street`, `city`, `municipality`	`address.bag_id`, `address.postcode`, `address.house_number`, `address.house_number_ext`, `address.street`, `address.city`, `address.municipality`
`data.buildType`, `buildYear`, `useSurface`, `parcelSurface`, `volume`, `energyLabel`, `rooms`	`type.house_type`, `construction.construction_year`, `dimensions.living_area_m2`, `dimensions.plot_area_m2`, `dimensions.volume_m3`, `energy.energy_label`, `rooms.rooms` In `GET /v5/properties/{locator}`	Uit Woningkenmerken.
`data.indexedPrice`, `histTransactionPrice`, `histTransactionDate`	`data[].price_indexed`, `data[].price`, `data[].transaction_date` In `GET /v5/properties/{locator}/transactions`	Alle verkopen van de woning, met een contract.
`data.references[]`	`references[]` In `GET /v5/properties/{locator}/valuation/plus`
`data.numZip`, `medZip`, `numStr`, `medStr`	`market.transactions_count`, `market.avg_transaction_price` In `GET /v5/areas/{area}/stats`	Per buurt, wijk of gemeente; niet per postcode of straat.

Woningwaarde met eigen kenmerken

GET /homevalue → POST /v5/valuations/scenarios

Matrixian	Huispedia	Opmerking
`postalCode`, `houseNumber`, `houseNumberExt`	`data[].postcode`, `data[].house_number`, `data[].house_number_ext`
`useSurface`	`data[].living_area_m2`
`parcelSurface`, `volume`	`data[].plot_area_m2`, `data[].volume_m3`
`buildYear`, `numberOfRooms`	`data[].construction_year`, `data[].rooms`
`buildType`	`data[].house_type`	`terraced`, `corner`, `semi_detached`, `detached` of `apartment`.
`energyLabel`	`data[].energy_label`
`monument`	Niet beschikbaar hier
`data.predictedValue`	`data[].valuation.value`

Woningkenmerken

GET /mx-house-details → GET /v5/properties/{locator}

Matrixian	Huispedia	Opmerking
`objectType`	`type.object_type`
`buildYear`	`construction.construction_year`
`livingSurface`, `useSurface`	`dimensions.living_area_m2`, `dimensions.bag_area_m2`
`otherIndoorSpace`, `attachedOutdoorSpace`, `externalStorageSpace`	`dimensions.other_indoor_m2`, `dimensions.building_bound_outdoor_m2`, `dimensions.external_storage_m2`
`parcelSurface`, `volume`	`dimensions.plot_area_m2`, `dimensions.volume_m3`
`numberOfRooms`, `numberOfBedrooms`, `numberOfBathrooms`, `numberOfToilets`	`rooms.rooms`, `rooms.bedrooms`, `rooms.bathrooms`, `rooms.separate_toilets`
`energyLabel`	`energy.energy_label`
`energyLabelRegistrationValidUntil`	`valid_to` In `GET /v5/properties/{locator}/energy-label`
`latitude`, `longitude`	`address.location.lat`, `address.location.lon`
`bagObjectId`, `bagBuildingId`, buurt- en gemeentecodes	`bag_verblijfsobject_id`, `bag_pand_id`, `neighbourhood.code`, `municipality_code` In `GET /v5/addresses/{locator}`
`description`	Niet beschikbaar hier

Referentiewoningen

GET /mx-reference-finder → GET /v5/properties/{locator}/references

Matrixian	Huispedia	Opmerking
`nReferences`	`?limit=`	3 tot 30.
`valuationDate`	`?as_of_date=`
`maxDistance`, `minTransportDate`	`?max_distance_m=`, `?max_age_months=`
`minUseSurface`, `maxUseSurface`	`?min_living_area_m2=`, `?max_living_area_m2=`
`minBuildYear`, `maxBuildYear`	`?min_construction_year=`, `?max_construction_year=`
`allowedHouseTypes`	`?same_type=`	Alleen hetzelfde type, of alle types.
`locationWeight`, `houseDetailsWeight`, `transportDateWeight`	`?sort=`	Sorteer op `similarity`, `distance` of `date`; geen eigen gewichten.
`references[]`	`data[]`
`distance`, `dateSale`	`data[].distance_m`, `data[].transaction_date`
`houseType`, `buildYear`, `useSurface`	`data[].house_type`, `data[].construction_year`, `data[].living_area_m2`
`referenceScore`, `locationScore`, `houseDetailsScore`	Niet beschikbaar hier
`offeredPrice`, `imageFront`, `description`	Niet beschikbaar hier

Transacties

GET /mx-transaction-finder → GET /v5/properties/{locator}/transactions

Matrixian	Huispedia	Opmerking
`valuationDate`, `dateTransport`	Niet beschikbaar hier	Je krijgt alle verkopen van de woning; filter zelf op `transaction_date`.
`saleDate`, `transportDate`	`data[].price_agreement_date`, `data[].transaction_date`
`transactionPrice`	`data[].price`
`transactionPriceIndexed`	`data[].price_indexed`	Op het prijsniveau van vandaag.

WOZ-waarde

GET /woz-value → GET /v5/properties/{locator}/woz

Matrixian	Huispedia	Opmerking
`wozValues[].valuationDate`, `wozValue`	`values[].reference_date`, `values[].value`
`characteristics`	`type`, `dimensions`, `construction` In `GET /v5/properties/{locator}`

Buurtinformatie

GET /buurtinfo → GET /v5/areas/{area}/demographics

Matrixian	Huispedia	Opmerking
`buurtCode` of een adres	`{area}`	Codes via `GET /v5/areas/lookup?postcode=`.
`Bevolking`	`population`, `households`, `age`
`Wonen`	`stock` In `GET /v5/areas/{area}/stats`
`geometry`	`geometry` In `GET /v5/areas/{area}`	Met `include=geometry`.
`Inkomen`, `Energie`, `Criminaliteit`	Niet beschikbaar hier

Fouten

Een fout is application/problem+json met een vaste code; elke code staat op Fouten.

Matrixian	Huispedia	Opmerking
`400` (`errors[].reason` is de parameter)	`400 invalid_request`	`errors` noemt per veld wat er mis is.
`401`	`401 unauthenticated`, `401 key_revoked`, `401 key_expired`
`403` (`access_denied`, `missing_subscription`)	`403 entitlement_required`, `403 forbidden`
`403` (`rate_limit`)	`429 rate_limited`	Hier `429`; wacht `Retry-After` seconden.
`404` (onbekend adres)	`404 not_found`
`500`	`500 internal_error`
`503`	`503 upstream_unavailable`
`{id, status: "failure", error: {code, message, errors}}`	`application/problem+json` met `code`, `detail`, `errors`, `request_id`

Bulk en limieten

	Matrixian	Huispedia
Snelheid	Niet gepubliceerd; bij de limiet `403 rate_limit`	6 per seconde en 6 tegelijk met een betaald plan; 1 en 2 op Free; `X-RateLimit-Remaining` in elk antwoord
Bulk	Geen bulk-endpoint gedocumenteerd	`POST /v5/valuations/scenarios`: 100 woningen per aanroep
Correlatie	`id`, `X-Amzn-Trace-Id`	`meta.request_id`, `request_id`

Matrixian

curl "https://api.matrixian.com/v1/homevalue?postalCode=1076LJ&houseNumber=12&houseNumberExt=2" \
  -H "Authorization: Bearer $MATRIXIAN_KEY"

Huispedia

curl https://huispedia.dev/v5/properties/1076LJ-12-2/valuation \
  -H "Authorization: Bearer $HUISPEDIA_KEY"

Matrixian

import os, requests

r = requests.get(
    "https://api.matrixian.com/v1/homevalue",
    headers={"Authorization": f"Bearer {os.environ['MATRIXIAN_KEY']}"},
    params={"postalCode": "1076LJ", "houseNumber": 12, "houseNumberExt": "2"},
)
value = r.json()["data"]["predictedValue"]

Huispedia

import os, requests

r = requests.get(
    "https://huispedia.dev/v5/properties/1076LJ-12-2/valuation",
    headers={"Authorization": f"Bearer {os.environ['HUISPEDIA_KEY']}"},
)
r.raise_for_status()
v = r.json()["valuation"]
value, lower, upper = v["value"], v["lower"], v["upper"]

Verschillen

Niet beschikbaar hier

Beschikbaarheid vooraf (/homevalue/available): niet beschikbaar hier; een 404 not_found kost geen credits.
Monumentstatus als invoer van de waardering (monument): niet beschikbaar hier.
Marktcijfers per postcode of straat (numZip*, numStr*): niet beschikbaar hier; wel per buurt.
Eigen gewichten en scores per referentiewoning: niet beschikbaar hier; de volgorde geeft de gelijkenis.
Inkomen, energie en criminaliteit per buurt: niet beschikbaar hier.
Woonlasten (/local-tax-energy-expenses): niet beschikbaar hier.
Woningfoto's (/house-images, /get_front_view): niet beschikbaar hier.
Kadastrale objecten en eigendomsberichten: niet beschikbaar hier.
Commerciële transacties: niet beschikbaar hier.

Geen equivalent bij Matrixian

Een interval met ondergrens en bovengrens bij elke waardering: geen equivalent bij Matrixian, behalve de bandbreedte-string van de Leadtool.
409 address_ambiguous met de kandidaten als een adres meerdere woningen heeft: geen equivalent bij Matrixian.
Wat-als-scenario's en tot 100 woningen per aanroep: geen equivalent bij Matrixian.
Maandelijkse waardehistorie: geen equivalent bij Matrixian.
Prijsindex per gebied (/v5/areas/{area}/trends): geen equivalent in Matrixians openbare documentatie.
Leefomgeving (fundering, bodemdaling, geluid, lucht) per adres: geen equivalent in Matrixians openbare documentatie.

Bronnen

Vorige
Overstappen van Altum