Docs

Objekte (Lesen)

Zuletzt aktualisiert: 2026-07-243 Min. Lesezeit

Lesen Sie den öffentlichen Katalog der Inserate - property, rental und complex (Bauprojekt). Die Antworten folgen einem festen, ausdrücklich erlaubten Vertrag für das Lesen, interne Felder gelangen also nie nach draußen und neue Felder des Modells tauchen nicht überraschend auf. Lesen geschieht mit GET und ist kostenlos (es zählt nicht gegen Ihr Kontingent an API-Aufrufen).

Grundadresse: https://developers.grem.capital/api/v1.

Liste

GET /objects?kind=property&city=Kyiv&page=1&limit=20&sort=newest
Authorization: Bearer gsk_live_...

Parameter der Anfrage:

  • kind (Pflicht) — property, rental oder complex
  • city, country (freiwillig) — Filter mit genauer Übereinstimmung
  • page (Vorgabe 1), limit (Vorgabe 20, höchstens 50)
  • sort — newest (Vorgabe) oder oldest

Antwort:

{
  "data": [ { "id": "...", "kind": "property", "name": "...", "price": 120000, "currency": "USD", ... } ],
  "paginate": { "currentPage": 1, "totalPages": 471, "totalCount": 9412 },
  "requestId": "req_..."
}

Ein einzelnes holen

GET /objects/{kind}/{id}
Authorization: Bearer gsk_live_...

{kind} ist property, rental oder complex. Gibt ein einzelnes Objekt im selben Aufbau zurück, dazu eine requestId. Eine unbekannte Kennung gibt 404 zurück.

Der Aufbau eines Objekts

Gemeinsame Felder (der genaue Satz hängt von der Art ab):

  • id, kind, name, slug, status (active oder sold), createdAt
  • price, currency (property/rental); price: { from, to, currency } (complex)
  • address — die vollständige Adresse samt street und den Koordinaten in location
  • constructionYear — ein einfaches vierstelliges Jahr (null, wenn unbekannt)
  • Flächen sind Objekte: spaceAll: { "value": 50, "unit": "m2" }; der Hinweis zur Anzeige ist nativeAreaUnit
  • photos — [{ id, isMain, mimetype, variants, ready }]
  • author — der Agent oder die Agentur des Inserats (ein gepflegter öffentlicher Block)
  • Beim Komplex kommen apartmentPlans[] (Grundrisse der Einheiten) und progress[] (Baufortschritt) hinzu

Felder der Kategorien und Merkmale (type, condition, utilitySystem, apartType, amenities, status und andere) kommen als Codes zurück. Übersetzen Sie sie über den Endpunkt Verzeichnisse.

Jedes Foto hat das Merkmal ready. Es ist false, solange die Varianten mit Wasserzeichen noch entstehen. Fragen Sie erneut nach (oder zeigen Sie einen Platzhalter), bis ready auf true steht, statt ein unfertiges Bild zwischenzuspeichern.

Was Sie sehen

Die Antwort richtet sich danach, wer Sie sind:

  • Jedes Objekt — die öffentliche Karte des Inserats (was Besucher auf grem.capital sehen).
  • Ein Inserat mit offener Provision — als angemeldeter Makler sehen Sie zusätzlich die Belohnung aus einem bestätigten Vertrag und können entscheiden, ob Sie einen Lead schicken.
  • Ihre eigenen Objekte — die vollständige Sicht des Eigentümers.

Niemandem gezeigt werden: private Kontakte des Eigentümers, importierte Angaben des Verkäufers, Notizen der Moderation, Originale der Fotos ohne Wasserzeichen und interne Kennungen.

War dieser Artikel hilfreich?