ทีดินไอคิว

개발자 및 기관용

TeedinIQ Data API — 태국 토지 + AVM 데이터를 API로

은행, 자산관리회사(AMC), 감정평가 회사, 부동산 펀드를 위해 필지 데이터, 재무부 평가가, AVM(참고가)에 프로그래밍 방식으로 접근하세요.

엔드포인트 레퍼런스

모든 엔드포인트는 /api/v1 기본 경로 아래에 있으며 JSON을 반환하고 API 키가 필요합니다

예시의 값은 응답 구조를 보여주기 위한 예시일 뿐이며, 실제 필지의 실제 출력이 아닙니다.

หมายเหตุ: ฟิลด์วิเคราะห์ (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

필지 또는 지역(도/군/area_wah)의 AVM(참고가)을 범위 및 신뢰도와 함께 요청(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"
}

인증

모든 요청은 HTTP 헤더로 API 키를 포함해야 합니다

모든 요청의 X-API-Key 헤더에 API 키를 전송하세요. 키는 tdiq_live_… 형식입니다. 비밀로 유지하고 웹 또는 모바일 클라이언트 코드에 포함하지 마세요.

X-API-Key: tdiq_live_xxxxxxxx

API 키 발급 방법

Team 요금제 고객은 대시보드에서 Free Dev(샌드박스) 키를 직접 즉시 발급할 수 있습니다. 유료 데이터 요금제(Startup / Business / Enterprise)는 조직과 요금제를 확인한 후 저희 팀이 발급합니다.

이미 키가 있으신가요? 대시보드 → API 키에서 확인, 폐기, 재발급할 수 있습니다.

코드 샘플

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를 실제 키로 교체하세요. 키를 저장소에 커밋하지 마세요

API 요금제

데이터를 연 약 20,000~25,000 THB에 판매하는 REIC를 기준으로 책정 — 가격은 7% VAT 별도

API 요금제
항목Free Dev(샌드박스)StartupBusiness가장 인기Enterprise
일일 쿼터일 500 요청일 20,000 요청일 200,000 요청일 5,000,000 요청
속도 제한분당 30 요청분당 120 요청분당 600 요청분당 3,000 요청
AVM 접근미지원미지원(Business 이상만)전체 AVM + 신뢰 구간AVM + 기관 전용 모델 + webhook
대량 조회페이지당 최대 20 필지페이지당 최대 50 필지페이지당 최대 100 필지페이지당 최대 200 필지
SLA / 지원커뮤니티 / 최선 노력 이메일이메일, 영업일 2일 이내이메일 + LINE, 영업일 1일 이내계약 SLA + 전담 매니저
가격0฿24,000฿/ 년96,000฿/ 년영업팀 문의

약관 및 규정 준수