ทีดินไอคิว

สำหรับนักพัฒนาและองค์กร

TeedinIQ Data API — ข้อมูลที่ดิน + AVM ของไทยผ่าน API

เข้าถึงข้อมูลแปลงที่ดิน ราคาประเมินกรมธนารักษ์ และ AVM (ราคาอ้างอิง) แบบเป็นโปรแกรม สำหรับธนาคาร บริษัทบริหารสินทรัพย์ (AMC) บริษัทประเมิน และกองทุนอสังหาริมทรัพย์

รายการ Endpoint

ทุก endpoint อยู่ใต้ base path /api/v1 ตอบกลับเป็น JSON และต้องมี API key

ค่าตัวเลขในตัวอย่างเป็นค่าสมมติเพื่อแสดงโครงสร้างข้อมูลเท่านั้น ไม่ใช่ผลลัพธ์จริงของแปลงใดแปลงหนึ่ง

หมายเหตุ: ฟิลด์วิเคราะห์ (deal_score, deal_class, assessed_price_per_wah) คืนค่า null อยู่ในขณะนี้ทุกแพ็กเกจ — เราจะเปิดใช้งานก็ต่อเมื่อโมเดล ผ่านการทดสอบย้อนหลังกับราคาขายจริงจากกรมบังคับคดีแล้วเท่านั้น ข้อมูลข้อเท็จจริง (ราคา พื้นที่ ทำเล น้ำท่วม ผังเมือง ประวัติการลดราคา) ใช้งานได้ตามปกติ

GET/api/v1/parcels

ค้นหาแปลงที่ดินตามจังหวัด/อำเภอ/คะแนนดีล พร้อมราคาอ้างอิงต่อ ตร.วา

พารามิเตอร์หลัก

province, district, source_type, min_price, max_price, min_area, max_area, deal_class, page, page_size

ตัวอย่างการตอบกลับ (JSON)

{
  "items": [
    {
      "id": "prc_8f2a10",
      "source_type": "npa",
      "title": "ที่ดินติดถนน อ.ศรีราชา",
      "price_thb": 18000000,
      "area_wah": 800,
      "price_per_wah": 22500,
      "province": "ชลบุรี",
      "district": "ศรีราชา",
      "lat": 13.17,
      "lng": 100.93,
      "posted_date": "2026-06-30",
      "status": "active",
      "assessed_price_per_wah": null,
      "deal_score": null,
      "deal_class": null,
      "motivated_seller": true,
      "price_drop_count": 2,
      "flood_zone": false,
      "flood_repeat_count": 0,
      "zoning_code": "อุตสาหกรรม",
      "zoning_desc": "ผังเมือง: พื้นที่สีม่วง",
      "risk_flags": []
    }
  ],
  "total": 1243,
  "page": 1,
  "page_size": 20,
  "plan": "business"
}
GET/api/v1/parcels/{id}

รายละเอียดแปลงเดียว: ราคาประเมิน ผังเมือง ความเสี่ยงน้ำท่วม และช่วง AVM

พารามิเตอร์หลัก

parcel_id (path)

ตัวอย่างการตอบกลับ (JSON)

{
  "parcel": {
    "id": "prc_8f2a10",
    "source_type": "npa",
    "province": "ชลบุรี",
    "district": "ศรีราชา",
    "area_rai": 2,
    "area_wah": 800,
    "price_per_wah": 22500,
    "assessed_price_per_wah": null,
    "zoning_code": "อุตสาหกรรม",
    "zoning_desc": "ผังเมือง: พื้นที่สีม่วง",
    "flood_zone": false,
    "flood_repeat_count": 0,
    "deal_score": null,
    "deal_class": null,
    "risk_flags": []
  },
  "price_history": [
    { "price_thb": 19500000, "price_per_wah": 24375, "captured_at": "2026-04-01T00:00:00" },
    { "price_thb": 18000000, "price_per_wah": 22500, "captured_at": "2026-06-15T00:00:00" }
  ],
  "plan": "business"
}
GET/api/v1/valuation

ขอ AVM (ราคาอ้างอิง) ของแปลงหรือของทำเล (จังหวัด/อำเภอ/area_wah) พร้อมช่วงราคาและความเชื่อมั่น (เฉพาะแพ็กเกจ Business/Enterprise)

พารามิเตอร์หลัก

parcel_id | (province, district, area_wah), assessed_ppw (query)

ตัวอย่างการตอบกลับ (JSON)

{
  "input": {
    "parcel_id": null,
    "province": "ชลบุรี",
    "district": "ศรีราชา",
    "area_wah": 400,
    "assessed_ppw": 18500
  },
  "valuation": {
    "estimate": 10720000,
    "low": 9433600,
    "point": 10720000,
    "high": 12006400,
    "estimate_ppw": 26800,
    "confidence": "high",
    "method": "blend(market+assessment)",
    "cohort_size": 24,
    "disclaimer": "estimate / ราคาอ้างอิง — ไม่ใช่ราคาประเมินทางการ"
  },
  "plan": "business"
}
GET/api/v1/zone-stats

สถิติรายโซน: จำนวนแปลง ราคาอ้างอิงกลาง และจำนวนแปลงต่ำกว่าราคาประเมิน

พารามิเตอร์หลัก

province (required), district, months

ตัวอย่างการตอบกลับ (JSON)

{
  "province": "ระยอง",
  "district": null,
  "count": 512,
  "median_price_per_wah": 15200,
  "cheap_deal_count": 88,
  "trend": [],
  "plan": "free_dev"
}

การยืนยันตัวตน (Authentication)

ทุกคำขอต้องแนบ API key ผ่าน HTTP header

ส่ง API key ของคุณในส่วนหัว X-API-Key ของทุกคำขอ คีย์รูปแบบ tdiq_live_… เก็บเป็นความลับ ห้ามฝังในโค้ดฝั่งเว็บหรือแอปมือถือ

X-API-Key: tdiq_live_xxxxxxxx

ขอ API key อย่างไร

สมาชิกแพ็กเกจ Team ออกคีย์ Free Dev (Sandbox) ได้เองทันทีจากแดชบอร์ด — ไม่ต้องรอทีมงาน ส่วนแพ็กเกจข้อมูลแบบชำระเงิน (Startup / Business / Enterprise) ทีมขายจะออกคีย์ให้หลังยืนยันองค์กรและแพ็กเกจ

มีคีย์อยู่แล้ว? ดู เพิกถอน หรือออกคีย์ใหม่ได้ที่ แดชบอร์ด → API key

ตัวอย่างโค้ด

cURL

curl -H "X-API-Key: tdiq_live_xxxxxxxx" \
  "https://api.teediniq.com/api/v1/parcels?province=ชลบุรี&deal_class=cheap"

Python (requests)

import requests

resp = requests.get(
    "https://api.teediniq.com/api/v1/parcels",
    headers={"X-API-Key": "tdiq_live_xxxxxxxx"},
    params={"province": "ชลบุรี", "deal_class": "cheap"},
)
data = resp.json()
print(data["total"])

JavaScript (fetch)

const res = await fetch(
  "https://api.teediniq.com/api/v1/parcels?province=ชลบุรี&deal_class=cheap",
  { headers: { "X-API-Key": "tdiq_live_xxxxxxxx" } }
);
const data = await res.json();
console.log(data.total);

แทนที่ tdiq_live_xxxxxxxx ด้วยคีย์จริงของคุณ — อย่า commit คีย์ลง repository

แพ็กเกจ API

ราคาอ้างอิงเทียบ REIC ที่ขายข้อมูลราว 20,000–25,000 บาท/ปี — ราคายังไม่รวม VAT 7%

แพ็กเกจ API
รายละเอียดFree Dev (Sandbox)StartupBusinessยอดนิยมEnterprise
โควตาต่อวัน500 คำขอ/วัน20,000 คำขอ/วัน200,000 คำขอ/วัน5,000,000 คำขอ/วัน
อัตราจำกัด30 คำขอ/นาที120 คำขอ/นาที600 คำขอ/นาที3,000 คำขอ/นาที
การเข้าถึง AVMไม่รองรับไม่รองรับ (เฉพาะ Business ขึ้นไป)AVM เต็มรูปแบบ + ช่วงความเชื่อมั่นAVM + โมเดลเฉพาะองค์กร + webhook
ดึงข้อมูลจำนวนมาก (bulk)สูงสุด 20 แปลง/หน้าสูงสุด 50 แปลง/หน้าสูงสุด 100 แปลง/หน้าสูงสุด 200 แปลง/หน้า
SLA / ซัพพอร์ตชุมชน / อีเมล best-effortอีเมล ภายใน 2 วันทำการอีเมล+ไลน์ ภายใน 1 วันทำการSLA มีสัญญา + ผู้ดูแลบัญชี
ราคา0฿24,000฿/ ปี96,000฿/ ปีติดต่อฝ่ายขาย

ข้อกำหนดและการปฏิบัติตามกฎหมาย