henzeb / housepedia-intelligence

v1.0.0 2026-11-08 21:35 UTC

Requires

• php: ^8.3
• php-http/discovery: ^1.19
• psr/http-client: ^1.0
• psr/http-client-implementation: ^1.0
• psr/http-factory: ^1.1
• psr/http-factory-implementation: ^1.0
• psr/http-message: ^1.1|^2.0

Requires (Dev)

• guzzlehttp/guzzle: ^7.8|^8.0
• pestphp/pest: ^4.0|^5.0
• php-http/httplug: ^2.4.1
• php-http/mock-client: ^1.6.1
• phpstan/phpstan: ^2.1

MIT

• Henze Berkheij

• geocoding
• address
• sdk
• postcode
• bag
• real estate
• netherlands
• Dutch
• adres
• psr-18
• kadaster
• valuation
• henzeb
• cbs
• housepedia
• huispedia
• housepedia intelligence
• property data
• woz
• energy label
• vastgoed
• woning
• woningwaarde
• waardebepaling
• taxatie
• energielabel
• buurt
• makelaar

Published on Packagist.org on 2026-11-08 21:37 UTC

README

A framework-independent PHP SDK for the Housepedia Intelligence API (v5): home values, property characteristics, WOZ values, energy labels, transactions, buildings and neighbourhood statistics for every address in the Netherlands.

Create an account and an API key at huispedia.dev. The API reference and pricing are in the documentation.

Responses are returned as immutable, typed objects. Endpoints that return a list return a plain PHP list of those objects.

Using Laravel? Install henzeb/housepedia-intelligence-laravel for configuration, a facade and Laravel Collections.

Table of contents

• Installation
• Usage
• Documentation
• Testing this package
• Security
• Credits
• License

Installation

You may install the package via Composer:

composer require henzeb/housepedia-intelligence

The SDK sends its requests through any PSR-18 HTTP client. When your project already has one, such as Guzzle or the Symfony HTTP client, it is discovered automatically.

Usage

use Henzeb\Housepedia\Intelligence\Client;

$client = Client::create($apiKey);

$address = $client->addresses()
    ->withPostcode('1076LJ', 12, '2')
    ->find();

$address->street();
$address->city();

$suggestions = $client->addresses()
    ->suggest('1076LJ 12-2'); // list<AddressSuggestion>

$valuation = $client->properties()
    ->withPostcode('1076LJ', 12, '2')
    ->valuation();

$valuation->valuation()->value(); // 888264

Documentation

• Getting Started
• Addresses
• Properties
• Buildings
• Areas
• Scenario Valuations
• Account and Catalog
• Raw Requests
• Using this SDK with an AI agent
• Errors

Testing this package

composer test
composer analyse

Security

If you discover any security-related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Henze Berkheij

License

The MIT License (MIT). Please see License File for more information.