地圖實價報告專家

獵戶陽光實價通 API

v1.0.0

最後更新:2026-04-14

GET/api/listings

掛牌搜尋

搜尋可用掛牌,支持多種篩選條件

參數

名稱類型必填說明
latnumber否緯度 (搜尋中心)
lngnumber否經度 (搜尋中心)
radiusnumber否搜尋半徑 (km)
districtstring否行政區
typestring否物業類型
minPricenumber否最低價格 USD
maxPricenumber否最高價格 USD
sortstring否排序方式 (price, date, distance)
pagenumber否頁碼
limitnumber否每頁筆數

請求範例

GET /api/listings?district=BKK1&minPrice=500000&maxPrice=2000000&sort=price&page=1&limit=20

回應範例

{
  "success": true,
  "data": [
    {
      "id": "lst_001",
      "title": "BKK1 Premium Apartment",
      "type": "apartment",
      "price": 1500000,
      "district": "BKK1",
      "lat": 11.5564,
      "lng": 104.9267,
      "area": 120,
      "unitPrice": 12500,
      "listingDate": "2026-04-10",
      "contact": "王先生",
      "phone": "(855) 12-345-678"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 847,
    "pages": 43
  }
}

錯誤碼

400無效的查詢參數
404未找到相符的掛牌
500伺服器錯誤

API 端點

基礎 URL

https://api.orionai.group

認證

使用 API Key 在 Header 中:Authorization: Bearer YOUR_API_KEY