Immobilie verkaufen Ich bin Makler
Meine Suchergebnisse Meine Daten Logout
Registrieren Alle Immobilien durchsuchen

zoomsquare zoomLIVE API

zoomLIVE ist eine Echtzeit-Schnittstelle für Betreiber von Immobilienportalen, über die sofort nach Schaltung neuer Anzeigen ihrer Kunden (Makler und Eigentümer) unsere Interessenten auf zoomsquare informiert werden können.

zoomLIVE ist eine Echtzeit-Schnittstelle für Betreiber von Immobilienportalen, über die sofort nach Schaltung neuer anzeigen ihrer Kunden (Makler und Eigentümer) unsere Interessenten auf zoomsquare informiert werden können.

Dies soll erreicht werden, indem nach jeder Veröffentlichung, Änderung oder Entfernung einer Immobilienanzeige zoomsquare darüber in Echtzeit informiert wird. Dabei wird eine einfache HTTP Anfrage an den zoomLIVE API-Endpunkt geschickt.

Ohne Unterstützung der zoomLIVE API seitens eines Portalbetreibers können Anzeigenseiten von zoomsquare nicht sofort neu indexiert werden.

Integration

Der Integrationsaufwand für zoomLIVE ist äußerst minimal, da nur die URL der Anzeige an zoomsquare geschickt wird und kein komplexer Datenaustausch (wie z.B. durch OpenImmo, etc.) nötig ist. Über die zoomLIVE API wird lediglich der Suchmaschine mitgeteilt, dass sich Anzeigenseiten geändert haben. Es ist deshalb auch keine Authentifizierung notwendig.

zoomLive sendet Antworten im [JSend](http://labs.omniti.com/labs/jsend)-Format. Des weiteren wird im Fehlerfall ein entsprechender Statuscode gesetzt. Die genauen Codes sind im Folgenden dokumentiert.

Aufbau der Dokumentation

Die Dokumentation der zoomLive-API ist wiefolgt aufgebaut:

http://api.zoomsquare.com

  • HTTP-Methode: Die Methode der HTTP-Anfrage (GET, POST, PUT, DELETE)
  • API-Version: Verwendete Version der zoomsquare-API im Format v[VERSIONSNUMMER].
  • Endpoint:Der angesprochene Endpunkt (Funktion) der aufgerufen wird.
  • BODY: Im Falle einer POST oder PUT-Anfrage der BODY-Teil der Anfrage im JSON-Format.

API-Endpunkte

/recrawl

Beim Recrawl-Endpunkt wird ein priorisieter Recrawl veranlasst. Das bedeutet, dass zoomsquare die Anzeigenseite möglichst zeitnah neu indexiert.

Ein Recrawl sollte in folgenden Fällen von der Portalsoftware veranlasst werden:

  • neues Inserat wird eingestellt
  • bereits vorhandenes wird aktualisiert
  • Inserat wird entfernt

Dies hilft zoomsquare dabei seinen Suchmaschinenindex aktuell zu halten und potentielle Interessenten sofort zu informieren.

POST http://api.zoomsquare.com/v1/recrawl {
    "url": "http://www.example.org/anzeigen/immo123.html"
}

Diese Anfrage veranlasst den Crawler von zoomsquare dazu die URL http://www.example.org/anzeigen/immo123.html priorisiert zu indexieren.

/recrawl (Bulk-Modus)

Dieser Endpunkt funktioniert ähnlich wie Recrawl, ermöglicht aber das Senden von mehreren Anzeigenlinks:}

POST http://api.zoomsquare.com/v1/recrawl/__bulk [
    {
        "url": "http://www.example.org/anzeigen/immo123.html"
    },{
        "url": "http://www.example.org/anzeigen/immo124.html"
    }
]

Sowohl http://www.example.org/anzeigen/immo123.html, als auch http://www.example.org/anzeigen/immo124.html werden priorisiert vom Crawler neu indexiert.