Skip to main content

Immowelt API

Immowelt API in eine Website einbauen

Manchmal machen Kunden uns das nicht immer ganz so einfach wie wir es gerne hätten. Dann kommt kein einfacher „iframe“ sondern eine etwas sehr umfangreiche Anleitung von der Makler-Plattform.

In diesem Fall haben wir vom Kunden seinen Immowelt API-Key (zwingend notwendig) und eine 59-seite „Anleitung“ von Immowelt. Diese ist leider mehr oder weniger verständlich gemacht worden. Wer also kein PHP-Pro ist und nichts versteht, kann sich den erworbenen Udemy-Kurs näher ansehen.

Wir haben aber nun ein Grundgerüst erstellt, mit dem man arbeiten kann. Durch die Klassen und Inline-CSS-Anweisungen kann man das auch etwas umgestalten.

P.S.: Bei WordPress ist das Plugin CSS & JavaScript Toolbox ganz hilfreich, da dieses PHP-Scripte in die Website einbauen lässt.

Ohne Design

Bei Implementierung kann das HTML-Grundgerüst entfernt werden (html-, head-, body-Tag) und durch ein Einfaches div-Tag ersetz werden

<html>
    <head>
        <!-- UIkit CSS -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/uikit@3.8.0/dist/css/uikit.min.css" />

<!-- UIkit JS -->
<script src="https://cdn.jsdelivr.net/npm/uikit@3.8.0/dist/js/uikit.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/uikit@3.8.0/dist/js/uikit-icons.min.js"></script>
</head>
<body>
<?php

    function get_words($sentence, $count = 10) {
        preg_match("/(?:\w+(?:\W+|$)){0,$count}/", $sentence, $matches);
        return $matches[0];
    }

    $client = new SoapClient('http://api.immowelt.de/WebServices/EstateService.asmx?WSDL');
    $authHeader = new SoapHeader('http://immowelt.de/services', 'ListAuthenticationHeader', array('ApiKey' => '64eb247ad3c8454ca91c5517ff13ec4a'));
    // define estate parameters
    
    /*$estateParameter[] = array('Key' => 'EType', 'Value' => '1,2,3');
    $estateParameter[] = array('Key' => 'ESR', 'Value' => '1');
    $estateParameter[] = array('Key' => 'PriMa', 'Value' => '50000');
    */
    // define search parameters
    $getEstateListParam = array(
        'GeoID' => '108',
        'parameter' => '',
        'CurrentPage' => 1,
        'PageSize' => 5,
        'ambit' => 1000
    );
    // get result from "GetListAmbit"
    // call GetListAmbit with ambit = -1 for an equal call to GetList
    // or define the ambit and get a smaller result-set.
    $response = $client->__soapCall('GetListAmbit', array('params' => $getEstateListParam), NULL, $authHeader);
    if ($response->GetListAmbitResult->Status == 'OK') {
        //print_r($response->GetListAmbitResult);

      


        echo '<div uk-grid>'        ;

        foreach ($response->GetListAmbitResult->EstatePropertyList as &$entry) {
            foreach ($entry as &$value){
                echo '<div>';
                echo $value->Category->_.'<br>';
               // echo $value->Description.'<br>';
               // echo substr($value->Description, 0, 5).'...<br>';
                echo get_words($value->Description, 3).'...<br>';

                echo $value->Zip.' '.$value->City.'<br>';
                echo $value->Price->_.'<br>';
                //echo $value->LivingArea->_.'<br>';
                echo (isset($value->LivingArea->_) ? $value->LivingArea->_ : "").'<br>';
                echo '<img src="'.$value->PreviewImage.'"/><br/>';
                echo '<a href="'.$value->UrlExpose.'">Objekt ansehen</a>';
                echo '</div>';

            }

             
    /*
            echo '<pre>';
            var_dump($entry);
            echo '</pre><br/><br/>';
      */  
        
        }
        echo '</div>';
    }



?>
</body>

Mit Design

Bei Implementierung kann das HTML-Grundgerüst entfernt werden (html-, head-, body-Tag) und durch ein Einfaches div-Tag ersetz werden. Hier als Beispiel schon angewendet:

<div>
<?php

    function get_words($sentence, $count = 10) {
        preg_match("/(?:\w+(?:\W+|$)){0,$count}/", $sentence, $matches);
        return $matches[0];
    }

    $client = new SoapClient('http://api.immowelt.de/WebServices/EstateService.asmx?WSDL');
    $authHeader = new SoapHeader('http://immowelt.de/services', 'ListAuthenticationHeader', array('ApiKey' => '64eb247ad3c8454ca91c5517ff13ec4a'));
    // define estate parameters
    
    /*$estateParameter[] = array('Key' => 'EType', 'Value' => '1,2,3');
    $estateParameter[] = array('Key' => 'ESR', 'Value' => '1');
    $estateParameter[] = array('Key' => 'PriMa', 'Value' => '50000');
    */
    // define search parameters
    $getEstateListParam = array(
        'GeoID' => '108',
        'parameter' => '',
        'CurrentPage' => 1,
        'PageSize' => 50,
        'ambit' => 1000,
        'UseBigImage' => true

    );
    // get result from "GetListAmbit"
    // call GetListAmbit with ambit = -1 for an equal call to GetList
    // or define the ambit and get a smaller result-set.
    $response = $client->__soapCall('GetListAmbitV2', array('params' => $getEstateListParam), NULL, $authHeader);
    if ($response->GetListAmbitV2Result->Status == 'OK') {
        //print_r($response->GetListAmbitResult);

      


        echo '<div class="uk-grid-divider uk-child-width-1-2@s uk-child-width-1-3@m uk-grid-medium" uk-grid>';

        foreach ($response->GetListAmbitV2Result->EstatePropertyList as &$entry) {
            foreach ($entry as &$value){
                echo '<div class="uk-card-default uk-card">';
                echo '<img src="'.$value->PreviewImage.'" width="380px" height="300px"/>';
               // echo $value->Description.'<br>';
               // echo substr($value->Description, 0, 5).'...<br>';
               echo '<h4 class="uk-text-primary uk-margin-small" style="color: #49b041;">'.$value->Category->_.'</h4>';
               echo '<h4 class="uk-margin-small" style="font-size: 18px;">'.get_words($value->Description, 30).'</h4>';

                echo '<p class="el-meta uk-text-meta uk-text-emphasis uk-margin-small-top">'.$value->Zip.' '.$value->City.'</p>';
                echo $value->Price->_.'<br>';
    
                //echo $value->LivingArea->_.'<br>';
                echo (isset($value->LivingArea->_) ? $value->LivingArea->_ : "").'<br><br>';
                echo '<a class="uk-button uk-button-primary uk-align-center" href="'.$value->UrlExpose.'" target="_blank">Objekt ansehen</a>';
                echo '</div>';

            }

             
    /*
            echo '<pre>';
            var_dump($entry);
            echo '</pre><br/><br/>';
      */  
        
        }
        echo '</div>';
    }



?>
</div>

Beispiel-Darstellung

Kunde: Helge Kersten Immobilien | https://intranet.almaron.de/crm/company/show/3698/