Integrationsleitfaden für die Housing Market API
Die Referenztabellen, Endpunktbeschreibungen, Fehlercodes und Beispiele werden aus der API-Spezifikation generiert und bleiben in jeder Sprache auf Englisch. Namen, Parameter und Codes sind überall identisch.
Überblick und Tarife
Die Housing Market API gibt Ihrer Software lesenden Zugriff auf veröffentlichte Immobilieninserate der Portale der Housing Market Group. Aggregierte Marktstatistiken sind im Tarif Advanced demnächst verfügbar.
Jede Anfrage geht über HTTPS an https://api.housingmarketapi.com, und jede Antwort ist JSON. Alle Endpunkte sind schreibgeschützt: Es handelt sich ausnahmslos um GET-Anfragen.
Es gibt zwei Tarife. Beide verwenden für Inserate denselben Schlüssel und dieselben Endpunkte.
- Standard: veröffentlichte Inserate mit allen in diesem Leitfaden beschriebenen Immobiliendetails, für die Länder, die Sie abonnieren.
- Advanced: alles aus Standard, dazu die Insights-Endpunkte (Suchvolumen, Lead-Volumen, Preise, Anzahl der Immobilien, Aktivitätsniveaus und Marktdaten von Drittanbietern), demnächst verfügbar. Advanced-Kunden erhalten Insights direkt nach dem Start mit demselben Schlüssel.
Insights sind Aggregate. Jeder Wert ist eine Anzahl oder ein Median für einen Ort und einen Zeitraum; nichts davon beschreibt eine einzelne Person, einen einzelnen Lead, Makler oder ein einzelnes Inserat.
Die Länder wählen Sie beim Abonnieren: einzelne Länder, eine Region oder weltweit. Sie können später Länder hinzufügen oder ein Upgrade vornehmen, und derselbe Schlüssel deckt sie dann ab.
Sie können monatlich oder jährlich bezahlen. Die Konsole zeigt Ihnen genau an, was Ihnen berechnet wird, bevor Sie bestätigen; daher werden in diesem Leitfaden keine Preise genannt.
Länder werden immer als ISO-Ländercodes angegeben, zum Beispiel TH für Thailand. Die Konsole listet die Länder auf, die Ihr Schlüssel abdeckt.