Krisha.kz — Недвижимость 图标

Krisha.kz 数据 API:房源、价格、电话

Kolesa Group · 电商

Krisha.kz — Недвижимость 是 Kolesa Group 推出的房产分类信息应用。Kolesa Group 总部位于阿拉木图,旗下除 krisha.kz 外,还运营 kolesa.kz 汽车交易平台。哈萨克斯坦的买家和租客可以在应用里搜索待售或长租的公寓、住宅与商业用房,查看新建住宅小区,在地图上标注搜索结果,并按入住与退房日期预订日租住宿。私人房东、中介和开发商在卖家后台管理在线、草稿与已归档的广告,使用 Krisha Agent 流程,并可订阅 Plus 获取更多发布工具。在 Google Play 上,它是该国主要房产信息平台的移动端入口,与 OLX Kazakhstan 及其他独联体分类信息平台争夺同一批房东和中介。

挂牌价字符串是 priceTitle 和 pricePerSquareMeter,与 mapLat/mapLon 及 addressTitle 并列,另有房东的 identificationResponse,以及包含 phones 和 workTimeData.isWorkingNow 的查看电话载荷。片区对比价以城市和区的 current 与 relative 均价形式给出;单条房源自己的序列则是 priceChangeText、isPriceUp 和 graphValues。

收藏同步带有分设备的 note 与 xPhoneId,以及 isDeleted 删除标记和 lastUpdatedAt 同步时间戳,使求房者的收藏清单可以在多台设备间合并。输入的街道地址会解析为 cityName、district、street 和 houseNumber,并返回 addressRegion.regionId 以及标注点的 latitude/longitude;新盘小区通过 apiGeoPoint 暴露同样的地图坐标。日租房东可读取评分 value 与 isBadgeActive 徽章,住客则分页查看评价的 rating 与 comment;推荐与相似房源卡片还会标注 hasVideo 和 isKrishaAgent。

后台房源行另有浏览量合计(total、byLastDay)和付费服务标记;已保存搜索暴露 notificationsEnabled、newAdvertIds 和 isPaymentRequired。账户对象包含 balance、bonusBalance 与 Plus 的 expiresAt;日租报价补充入住天数 days 和格式化的 price。收件箱会话带有 unread 和 lastMessage 文本。房价指数服务商、中介 CRM 和已保存搜索提醒机器人都在使用这一整套字段;openData Studio 将其转化为可调用的开放数据。

应用截图

  • Krisha.kz — Недвижимость 应用截图 1
  • Krisha.kz — Недвижимость 应用截图 2
  • Krisha.kz — Недвижимость 应用截图 3
  • Krisha.kz — Недвижимость 应用截图 4
  • Krisha.kz — Недвижимость 应用截图 5
  • Krisha.kz — Недвижимость 应用截图 6
  • Krisha.kz — Недвижимость 应用截图 7

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。

  • 搜索房源结果

    GET /v1/listings/search opendata

    返回分页的分类信息搜索结果(total、searchId、items.kind/model),供房源结果页使用,含 priceTitle、pricePerSquareMeter 与 geoLocation。

    认证方式: 可选的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发。匿名浏览仍会发送 appId/appKey 查询参数,以及请求头 app-platform、app-version、X-PHONE-ID 和 APP-PHOTO-FORMAT。

    • total
    • searchId
    • headers
    • items
    • kind
    • id
    • storageId
    • isNewBuilding
    • title
    • priceTitle
    • pricePerSquareMeter
    • geoLocation
    • city
    • district
    • addressTitle
    • mapLat
    • mapLon
    • mapZoom
    GET /v1/listings/search?appId=<app-id>&appKey=<app-key>&city=2&category=prodazha HTTP/1.1
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    APP-PHOTO-FORMAT: webp
    {
      "total": 18420,
      "searchId": "s-9f3a",
      "headers": [],
      "items": [
        {
          "kind": "advert",
          "model": {
            "id": "667001234",
            "storageId": "live",
            "isNewBuilding": false,
            "title": "2-комнатная квартира, 54 м²",
            "priceTitle": "35 000 000 ₸",
            "pricePerSquareMeter": "648 148 ₸",
            "geoLocation": {
              "city": "Алматы",
              "district": "Бостандыкский р-н",
              "addressTitle": "ул. Сатпаева 30",
              "mapLat": "43.238949",
              "mapLon": "76.889709",
              "mapZoom": 16
            }
          }
        }
      ]
    }
  • 获取房源详情

    GET /v1/listings/detail opendata

    加载单条分类信息(title、description、priceTitle、geoLocation、advertPhotos)及房东的 owner identificationResponse,供房源详情页使用。

    认证方式: 可选的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发。匿名浏览仍会发送 appId/appKey、app-platform、app-version 和 X-PHONE-ID。已登录访问者还会收到收藏与预订信息块。

    • id
    • storageId
    • title
    • description
    • priceTitle
    • pricePerSquareMeter
    • owner
    • globalId
    • identificationResponse
    • userStatus
    • contractStatus
    • geoLocation
    • region
    • street
    • houseNum
    • addressTitle
    • mapLat
    • mapLon
    • advertPhotos
    • count
    • path
    • isModerated
    GET /v1/listings/detail?id=667001234&appId=<app-id>&appKey=<app-key> HTTP/1.1
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    X-AUTH-TOKEN: <sso-token>
    {
      "id": "667001234",
      "storageId": "live",
      "title": "2-комнатная квартира, 54 м²",
      "description": "Светлая квартира у метро.",
      "priceTitle": "35 000 000 ₸",
      "pricePerSquareMeter": "648 148 ₸",
      "owner": {
        "id": 880012,
        "globalId": 990012,
        "type": 1,
        "name": "Алма",
        "identificationResponse": {
          "userStatus": "identified",
          "contractStatus": "signed"
        }
      },
      "geoLocation": {
        "region": "Алматы",
        "city": "Алматы",
        "district": "Бостандыкский р-н",
        "street": "Сатпаева",
        "houseNum": "30",
        "addressTitle": "ул. Сатпаева 30",
        "mapLat": "43.238949",
        "mapLon": "76.889709"
      },
      "advertPhotos": {
        "count": 12,
        "items": [
          {
            "id": 1,
            "path": "https://cdn.example.net/photos/1.webp",
            "isModerated": true
          }
        ]
      }
    }
  • 获取片区均价

    GET /v1/market/average-prices opendata

    返回房源所在片区的城市、区、当前及相对平均价,在详情页中显示于挂牌价旁边。

    认证方式: 可选的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • city
    • district
    • current
    • relative
    GET /v1/market/average-prices?id=667001234&appId=<app-id>&appKey=<app-key> HTTP/1.1
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "city": 620000,
      "district": 680000,
      "current": 648148,
      "relative": 0.95
    }
  • 获取房源价格历史

    GET /v1/listings/price-history opendata

    返回房源的价格变动序列(priceChangeText、isPriceUp、graphValues.date/formattedValue/heightPercentage),供详情页价格历史图表使用。

    认证方式: 可选的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • priceChangeText
    • isPriceUp
    • isVisible
    • differences
    • graphValues
    • date
    • formattedValue
    • heightPercentage
    GET /v1/listings/price-history?id=667001234&appId=<app-id>&appKey=<app-key> HTTP/1.1
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "priceChangeText": "−2 000 000 ₸",
      "isPriceUp": false,
      "isVisible": true,
      "differences": [],
      "graphValues": [
        {
          "date": "2026-07-01",
          "formattedValue": "37 000 000 ₸",
          "heightPercentage": 1.0
        },
        {
          "date": "2026-10-01",
          "formattedValue": "35 000 000 ₸",
          "heightPercentage": 0.95
        }
      ]
    }
  • 查看房东电话

    GET /v1/listings/contact-phones osint

    在用户点击房源卡片上的“致电”后,返回房东或中介的电话列表与 workTimeData.isWorkingNow。

    认证方式: 必需的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。查看电话需要已登录的会话。

    • data
    • phones
    • workTimeData
    • isWorkingNow
    GET /v1/listings/contact-phones?id=667001234&appId=<app-id>&appKey=<app-key> HTTP/1.1
    X-AUTH-TOKEN: <sso-token>
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "data": {
        "phones": ["+7 701 000 00 00"],
        "workTimeData": {
          "isWorkingNow": true
        }
      }
    }
  • 获取已登录用户资料

    GET /v1/account/current openfinance

    读取已登录卖家或求房者的资料,含 balance、bonusBalance、identificationStatus 与 plusSubscriptionInfo(active、expiresAt、isAuto、payerId)。

    认证方式: 必需的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version、X-PHONE-ID 和 APP-PHOTO-FORMAT。

    • id
    • localId
    • userId
    • userEmail
    • name
    • createdAt
    • isActivated
    • activatedAt
    • mainPhone
    • userPhones
    • balance
    • bonusBalance
    • identificationStatus
    • userStatus
    • contractStatus
    • plusSubscriptionInfo
    • active
    • expiresAt
    • isAuto
    • payerId
    GET /v1/account/current?appId=<app-id>&appKey=<app-key> HTTP/1.1
    X-AUTH-TOKEN: <sso-token>
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "id": 880012,
      "localId": 12045,
      "userId": 880012,
      "userEmail": "[email protected]",
      "name": "Алма",
      "createdAt": "2019-04-12T10:00:00+06:00",
      "isActivated": true,
      "activatedAt": "2019-04-12T10:05:00+06:00",
      "mainPhone": "+7 701 000 00 00",
      "userPhones": ["+7 701 000 00 00"],
      "balance": "12500",
      "bonusBalance": "300",
      "identificationStatus": {
        "userStatus": "identified",
        "contractStatus": "signed"
      },
      "plusSubscriptionInfo": {
        "active": true,
        "expiresAt": "2026-12-01T00:00:00+06:00",
        "isAuto": true,
        "payerId": 880012
      }
    }
  • 按存储区统计后台房源数量

    GET /v1/account/listing-counters opendata

    返回按存储区划分的房源计数(live、archive、draft、moder、limitPay、rejected),驱动卖家后台的各个标签页。

    认证方式: 必需的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • live
    • archive
    • delete
    • draft
    • moder
    • limitPay
    • rejected
    GET /v1/account/listing-counters?appId=<app-id>&appKey=<app-key> HTTP/1.1
    X-AUTH-TOKEN: <sso-token>
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "live": 12,
      "archive": 4,
      "delete": 1,
      "draft": 2,
      "moder": 0,
      "limitPay": 3,
      "rejected": 1
    }
  • 列出后台房源

    GET /v1/account/listings opendata

    按存储区(live/temp)分页读取卖家后台,每条房源附带 views.total、views.byLastDay 与 activePaidServices。

    认证方式: 必需的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • items
    • kind
    • id
    • status
    • storageId
    • regionId
    • title
    • priceTitle
    • photoUrl
    • isKrishaAgent
    • views
    • total
    • byLastDay
    • activePaidServices
    GET /v1/account/listings?storage=live&page=1&limit=20&appId=<app-id>&appKey=<app-key> HTTP/1.1
    X-AUTH-TOKEN: <sso-token>
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "items": [
        {
          "kind": "advert",
          "model": {
            "id": 667001234,
            "status": "live",
            "storageId": "live",
            "regionId": "2",
            "title": "2-комнатная квартира, 54 м²",
            "priceTitle": "35 000 000 ₸",
            "photoUrl": "https://cdn.example.net/photos/1.webp",
            "isKrishaAgent": false,
            "views": {
              "total": 1280,
              "byLastDay": 34
            },
            "activePaidServices": []
          }
        }
      ]
    }
  • 列出全部收藏房源

    GET /v1/favorites/list opendata

    分页返回已登录用户的已收藏与已删除收藏(nbTotal、lastUpdatedAt、note、xPhoneId),供收藏页使用。

    认证方式: 必需的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • lastUpdatedAt
    • nbTotal
    • limit
    • offset
    • saved
    • deleted
    • id
    • advertId
    • userId
    • isDeleted
    • note
    • type
    • updatedAt
    • xPhoneId
    GET /v1/favorites/list?limit=50&offset=0&type=0&withDeleted=0&appId=<app-id>&appKey=<app-key> HTTP/1.1
    X-AUTH-TOKEN: <sso-token>
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "lastUpdatedAt": "2026-10-08T12:00:00+06:00",
      "nbTotal": 18,
      "limit": 50,
      "offset": 0,
      "saved": {
        "667001234": {
          "id": 441,
          "advertId": "667001234",
          "userId": 880012,
          "isDeleted": false,
          "note": "Call Monday",
          "type": 0,
          "updatedAt": "2026-10-07T09:00:00+06:00",
          "xPhoneId": "<device-phone-id>"
        }
      },
      "deleted": {}
    }
  • 列出已保存搜索订阅

    GET /v1/saved-searches opendata

    返回已保存搜索订阅(notificationsEnabled、newAdvertIds、isPaymentRequired、isFree),驱动房源提醒。

    认证方式: 必需的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • items
    • subscriptionsCount
    • enabledSubscriptionsCount
    • hasNewAdverts
    • id
    • title
    • subTitle
    • notificationsEnabled
    • notificationFrequency
    • activeDaysText
    • frequencyText
    • lastViewedId
    • newAdvertIds
    • isPaymentRequired
    • isFree
    GET /v1/saved-searches?offset=0&limit=100&appId=<app-id>&appKey=<app-key> HTTP/1.1
    X-AUTH-TOKEN: <sso-token>
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "items": [
        {
          "id": 90210,
          "title": "2-комн., Алматы",
          "subTitle": "до 40 млн ₸",
          "notificationsEnabled": true,
          "notificationFrequency": 1,
          "activeDaysText": "7 дней",
          "frequencyText": "раз в день",
          "lastViewedId": 667000100,
          "newAdvertIds": [667001234],
          "isPaymentRequired": false,
          "isFree": true
        }
      ],
      "subscriptionsCount": 3,
      "enabledSubscriptionsCount": 2,
      "hasNewAdverts": true
    }
  • 按 id 获取分类

    GET /v1/categories/detail opendata

    返回一个分类信息类别(name、label、version、parameters),供搜索筛选与发布房源表单使用。

    认证方式: 可选的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • id
    • version
    • name
    • label
    • updated
    • isDisabled
    • parameters
    GET /v1/categories/detail?id=1&appId=<app-id>&appKey=<app-key> HTTP/1.1
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "id": 1,
      "version": 14,
      "name": "prodazha",
      "label": "Продажа",
      "updated": "2026-09-01T00:00:00+06:00",
      "isDisabled": 0,
      "parameters": []
    }
  • 获取新盘小区位置

    GET /v1/complexes/location opendata

    返回新盘住宅小区的地图标记点(type、apiGeoPoint.latitude/longitude)。

    认证方式: 可选的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • type
    • apiGeoPoint
    • latitude
    • longitude
    GET /v1/complexes/location?id=c-441&appId=<app-id>&appKey=<app-key> HTTP/1.1
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "type": "complex",
      "apiGeoPoint": {
        "latitude": 43.238949,
        "longitude": 76.889709
      }
    }
  • 房源地址地理编码

    GET /v1/map/geocode opendata

    把输入的街道地址解析为 details(cityName、district、street、houseNumber)、addressRegion.regionId 以及 point 的经纬度(latitude/longitude),供发布房源的地图使用。

    认证方式: 可选的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • details
    • city
    • cityName
    • country
    • district
    • locality
    • microdistrict
    • entrance
    • houseNumber
    • region
    • street
    • addressRegion
    • regionId
    • point
    • latitude
    • longitude
    GET /v1/map/geocode?q=%D1%83%D0%BB.%20%D0%A1%D0%B0%D1%82%D0%BF%D0%B0%D0%B5%D0%B2%D0%B0%2030&appId=<app-id>&appKey=<app-key> HTTP/1.1
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "details": {
        "city": "2",
        "cityName": "Алматы",
        "country": "KZ",
        "district": "Бостандыкский р-н",
        "locality": "",
        "microdistrict": "",
        "entrance": "",
        "houseNumber": "30",
        "region": "Алматы",
        "street": "Сатпаева"
      },
      "addressRegion": {
        "regionId": 2
      },
      "point": {
        "latitude": "43.238949",
        "longitude": "76.889709"
      }
    }
  • 计算日租预订价格

    GET /v1/stays/quote openfinance

    为日租住宿报价,返回 price、days 与 formatted.price/description,供房源上的预订计算器使用。

    认证方式: 可选的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。入住与退房日期通过 checkin 和 checkout 查询参数传递。

    • price
    • days
    • formatted
    • description
    GET /v1/stays/quote?id=667001234&checkin=2026-10-20&checkout=2026-10-23&appId=<app-id>&appKey=<app-key> HTTP/1.1
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "price": 45000,
      "days": 3,
      "formatted": {
        "price": "45 000 ₸",
        "description": "за 3 суток"
      }
    }
  • 列出日租预订评价

    GET /v1/stays/reviews opendata

    分页返回日租房源的住客评价(rating、comment、author.name、date)。

    认证方式: 可选的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • reviews
    • id
    • rating
    • comment
    • author
    • name
    • date
    GET /v1/stays/reviews?id=667001234&page=1&appId=<app-id>&appKey=<app-key> HTTP/1.1
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "reviews": [
        {
          "id": "r-441",
          "rating": 5,
          "comment": "Чистая квартира, удобный заезд.",
          "author": {
            "name": "Данияр"
          },
          "date": "2026-09-12"
        }
      ]
    }
  • 获取房源草稿

    GET /v1/listings/draft opendata

    返回进行中的发布房源草稿(lastScreen 加嵌套的 advert),让发布器可以接着编辑。

    认证方式: 必需的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • lastScreen
    • advert
    • id
    • storageId
    • title
    • priceTitle
    GET /v1/listings/draft?appId=<app-id>&appKey=<app-key> HTTP/1.1
    X-AUTH-TOKEN: <sso-token>
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "lastScreen": "photos",
      "advert": {
        "id": "d-88",
        "storageId": "temp",
        "title": "",
        "priceTitle": ""
      }
    }
  • 列出相关房源

    GET /v1/listings/related opendata

    返回显示在房源详情页下方的相似信息(title、priceTitle、photo、isKrishaAgent)。

    认证方式: 可选的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • id
    • title
    • photo
    • price
    • priceTitle
    • complexAlias
    • isFlatLayout
    • isKrishaAgent
    GET /v1/listings/related?id=667001234&appId=<app-id>&appKey=<app-key> HTTP/1.1
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    [
      {
        "id": "667009876",
        "title": "2-комнатная квартира, 58 м²",
        "photo": "https://cdn.example.net/photos/2.webp",
        "price": "36000000",
        "priceTitle": "36 000 000 ₸",
        "complexAlias": "",
        "isFlatLayout": false,
        "isKrishaAgent": true
      }
    ]
  • 列出收件箱会话

    GET /v1/chat/threads opendata

    分页返回买卖双方的收件箱会话(total、unread、subject、advertId、lastMessage.text),供消息标签页使用。

    认证方式: 必需的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发。查询参数包括 limit、offset 和可选的 advert_id;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • total
    • unread
    • offset
    • limit
    • status
    • threads
    • id
    • subject
    • advertId
    • unreadCount
    • isOnline
    • isPinned
    • updatedAt
    • other
    • userId
    • name
    • canChat
    • lastMessage
    • text
    • isOther
    GET /v1/chat/threads?limit=20&offset=0&appId=<app-id>&appKey=<app-key> HTTP/1.1
    X-AUTH-TOKEN: <sso-token>
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "total": 14,
      "unread": 3,
      "offset": 0,
      "limit": 20,
      "status": "ok",
      "threads": [
        {
          "id": 551002,
          "subject": "2-комнатная квартира, 54 м²",
          "advertId": 667001234,
          "unreadCount": 2,
          "isOnline": true,
          "isPinned": false,
          "updatedAt": "2026-10-08T11:40:00+06:00",
          "other": {
            "userId": "990012",
            "name": "Алма",
            "canChat": true
          },
          "lastMessage": {
            "id": 8801,
            "text": "Можно посмотреть завтра?",
            "isOther": true,
            "type": "text"
          }
        }
      ]
    }
  • 获取房东预订评分

    GET /v1/stays/host-rating opendata

    返回日租房东后台的评分与评价计数(value、isBadgeActive、deeplink),显示在房东首页。

    认证方式: 必需的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • rating
    • reviews
    • title
    • value
    • isBadgeActive
    • deeplink
    GET /v1/stays/host-rating?appId=<app-id>&appKey=<app-key> HTTP/1.1
    X-AUTH-TOKEN: <sso-token>
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "rating": {
        "title": "Рейтинг",
        "value": 4.8,
        "isBadgeActive": true,
        "deeplink": "app://booking/rating"
      },
      "reviews": {
        "title": "Отзывы",
        "value": 36.0,
        "isBadgeActive": false,
        "deeplink": "app://booking/reviews"
      }
    }
  • 列出推荐房源

    GET /v1/listings/recommended opendata

    返回插入搜索结果中的推荐卡片(advertId、priceTitle、addressTitle、hasVideo)。

    认证方式: 可选的持有者令牌(X-AUTH-TOKEN 请求头),由该市场集团的 SSO 签发,另带 appId/appKey 查询参数;每次调用都会发送 app-platform、app-version 和 X-PHONE-ID。

    • advertId
    • storageId
    • categoryId
    • priceTitle
    • title
    • addressTitle
    • photoUrl
    • hasVideo
    GET /v1/listings/recommended?appId=<app-id>&appKey=<app-key> HTTP/1.1
    app-platform: android
    app-version: 26.10.40
    X-PHONE-ID: <device-phone-id>
    {
      "items": [
        {
          "advertId": "667008001",
          "storageId": "live",
          "categoryId": "1",
          "priceTitle": "28 500 000 ₸",
          "title": "1-комнатная квартира, 38 м²",
          "addressTitle": "ул. Абая 48",
          "photoUrl": "https://cdn.example.net/photos/3.webp",
          "hasVideo": false
        }
      ]
    }

数据类别

  • 房源列表
  • 价格
  • 房东
  • 收藏
  • 已保存搜索
  • 后台统计
  • 预订
  • 消息

数据使用场景与案例

  • 片区价格指数

    估值数据流读取每条房源旁的 city、district、current 与 relative 均价,以及 priceTitle 和 pricePerSquareMeter,并在卖家降价或涨价时,绘制 priceChangeText、isPriceUp 与 graphValues.formattedValue 的变化。

  • 中介 CRM 后台同步

    中介工作台按 storageId 分页读取后台房源行,记录 views.total 与 views.byLastDay,并为处于 moder、limitPay 或 rejected 状态的广告开工单,让经纪人更新照片或付费解除卡住的房源。

  • 已保存搜索提醒机器人

    通知任务轮询已保存搜索的 notificationsEnabled 与 newAdvertIds,跳过 isPaymentRequired 为 true 的行,并把匹配的 priceTitle 卡片推送到求房者已在关注的渠道。

  • 房东电话 KYC 核验

    合规连接器把 identificationResponse.userStatus 和 contractStatus 与查看电话时返回的 phones 及 workTimeData.isWorkingNow 关联起来,只有已认证的房东才进入线索队列。

常见问题

Krisha.kz 的搜索会返回哪些房源字段?

每条搜索结果带有 id、storageId、title、priceTitle、pricePerSquareMeter,以及含 city、district、addressTitle、mapLat 和 mapLon 的 geoLocation 块,外加该结果集的 searchId。

能读取房东电话和身份认证信息吗?

详情载荷包含房东的 identificationResponse(userStatus、contractStatus)。点击“致电”后会加载 phones 和 workTimeData.isWorkingNow;该操作需要已登录的 Kolesa 会话。

Plus 和房源余额是如何表示的?

已登录的资料会以字符串形式返回 balance 和 bonusBalance,以及包含 active、expiresAt、isAuto 和 payerId 的 plusSubscriptionInfo。

中介可以把什么接入 CRM?

后台搜索分页读取 live 与 temp 存储区,带 views.total / byLastDay,以及 live、archive、draft、moder、limitPay 和 rejected 的计数,让工作台能处理被付费或审核卡住的广告。

与 Krisha.kz — Недвижимость 相似的应用

  • kn.kz — kn.kz 是哈萨克斯坦房地产分类信息网站,提供阿斯塔纳、阿拉木图、卡拉干达等城市的公寓和房屋买卖与租赁信息。
  • Nedvizhka.kz — Nedvizhka.kz 是哈萨克斯坦的买房租房应用,支持三维看房、视频介绍、地图搜索和免费发布房源。
  • Homsters — Homsters 是面向哈萨克斯坦的房地产应用,覆盖二手房、新盘、长短租、房屋土地和商业地产,并提供装修搬家等配套服务。
  • Korter — Korter 是面向开发商新房的房产平台,可在哈萨克斯坦等国通过网站和应用查看楼盘、户型和价格。
  • OLX — OLX 是综合分类信息平台;2014 年纳斯帕斯将哈萨克斯坦等地的分类站点统一为 OLX 品牌,用户可发布和浏览包括房产在内的各类信息。
  • Cian — Cian(Циан)是俄罗斯房地产服务,用于买卖或租赁公寓、房屋和商业物业,并提供筛选、业主房源和贷款相关工具。
  • Apartamenty.kz — Apartamenty.kz 收录哈萨克斯坦各城市的酒店和日租公寓,面向无中介的短租住宿,与 Krisha 的日租预订场景重合。

相关主题

  • Krisha.kz API
  • krisha 房源 priceTitle
  • 哈萨克斯坦房产分类信息
  • Kolesa Group Krisha
  • 房源 mapLat mapLon
  • Krisha 已保存搜索
  • 后台房源浏览量
  • Plus 订阅与余额

需要集成这个 App 的数据 API?

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。

  • 每个项目均签 NDA 与 SOW
  • 3–7 天交付
  • 验收通过后才付款
  • 仅在授权范围内作业

获取报价