Hướng dẫn tích hợp Housing Market API
Các bảng tham chiếu, mô tả endpoint, mã lỗi và ví dụ được tạo từ đặc tả API và được giữ nguyên bằng tiếng Anh ở mọi ngôn ngữ. Tên, tham số và mã đều giống nhau ở mọi nơi.
Tổng quan và các gói
Housing Market API cho phép phần mềm của bạn truy cập chỉ đọc vào các tin đăng bất động sản đã xuất bản trên các cổng thông tin của Housing Market Group. Thông tin thị trường tổng hợp sắp ra mắt ở gói Nâng cao.
Mọi yêu cầu đều được gửi đến https://api.housingmarketapi.com qua HTTPS và mọi phản hồi đều ở dạng JSON. Tất cả endpoint đều chỉ đọc: tất cả đều là yêu cầu GET.
Có hai gói. Cả hai đều dùng cùng một khóa và cùng các endpoint cho tin đăng.
- Tiêu chuẩn: tin đăng đã xuất bản với mọi thông tin chi tiết về bất động sản được mô tả trong hướng dẫn này, cho các quốc gia bạn đăng ký.
- Nâng cao: mọi thứ trong gói Tiêu chuẩn, cộng thêm các endpoint Insights (lượng tìm kiếm, lượng khách hàng tiềm năng, giá, số lượng bất động sản, mức độ hoạt động và dữ liệu thị trường của bên thứ ba), sắp ra mắt. Khách hàng gói Nâng cao sẽ nhận được Insights trên chính khóa đó ngay khi Insights ra mắt.
Insights là dữ liệu tổng hợp. Mỗi giá trị là một số đếm hoặc giá trị trung vị cho một địa điểm và một khoảng thời gian; không giá trị nào mô tả một cá nhân, khách hàng tiềm năng, môi giới hay tin đăng cụ thể.
Bạn chọn quốc gia khi đăng ký: từng quốc gia, một khu vực hoặc toàn cầu. Bạn có thể thêm quốc gia hoặc nâng cấp sau này, và khi đó cùng một khóa sẽ bao gồm cả những phần này.
Bạn có thể thanh toán hằng tháng hoặc hằng năm. Bảng điều khiển hiển thị chính xác số tiền bạn sẽ bị tính trước khi bạn xác nhận, vì vậy hướng dẫn này không nêu giá.
Quốc gia luôn được viết bằng mã quốc gia ISO, ví dụ TH cho Thái Lan. Bảng điều khiển liệt kê các quốc gia mà khóa của bạn bao gồm.