Объекты (чтение)

Чтение публичного каталога объявлений — property (вторичка), rental (аренда) и complex (ЖК). Ответы отдаются в явной стабильной форме (allowlist): внутренние поля не утекают, а новые поля модели не появляются неожиданно. Чтение — это GET, и оно бесплатное (не списывается из квоты вызовов).

Базовый URL: https://developers.grem.capital/api/v1.

Список

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

Параметры запроса:

• kind (обязательный) — property, rental или complex
• city, country (опц.) — фильтры точного совпадения
• page (по умолчанию 1), limit (по умолчанию 20, максимум 50)
• sort — newest (по умолчанию) или oldest

Ответ:

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

Один объект

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

{kind} — property, rental или complex. Возвращает один объект в той же форме плюс requestId. Неизвестный id — 404.

Форма объекта

Общие поля (точный набор зависит от типа):

• id, kind, name, slug, status (active или sold), createdAt
• price, currency (property/rental); price: { from, to, currency } (complex)
• address — полный адрес, включая street и координаты location
• constructionYear — обычный 4-значный год (null, если неизвестен)
• Площади — объекты: spaceAll: { "value": 50, "unit": "m2" }; подсказка отображения — nativeAreaUnit
• photos — [{ id, isMain, mimetype, variants, ready }]
• author — агент/агентство объявления (курируемый публичный блок)
• У complex добавлены apartmentPlans[] (планировки) и progress[] (ход строительства)

Что вы видите

Ответ зависит от того, кто вы:

• Любой объект — публичная карточка объявления (то, что видят посетители grem.capital).
• Объект под открытым комиссионным договором — как авторизованный брокер вы дополнительно видите вознаграждение по одобренному соглашению и можете решить, отправлять ли лид.
• Ваши собственные объекты — полный вид владельца.

Никому не отдаются: приватные контакты владельца, данные продавца из импорта, заметки модерации, оригиналы фото без водяного знака и внутренние идентификаторы.