리치고 부동산 (Richgo)

Find Korean apartment complexes by name or neighborhood and get their danji_id. 아파트 이름·동 이름으로 단지를 찾아 danji_id 를 돌려줍니다. 다른 도구를 쓰기 전에 먼저 부르세요.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "단지 이름 또는 동 이름 (예: 메이플자이, 반포동 래미안)",
      "maxLength": 40
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Richgo's 3-month-ahead sale price forecast for an apartment complex (one floor-plan size). 단지·평형의 3개월 뒤 매매 시세 예측(리치고 단기 예측: 과거 12개월 시세 흐름을 이어 본 통계 모델)과 기준 시세·변동률·전망(상승/유지/하락)을 돌려줍니다. "○○아파트 전망" 질문에 쓰세요. 추정치이며 투자 권유가 아닙니다.

{
  "type": "object",
  "properties": {
    "danji_id": {
      "type": "string",
      "description": "search_apartments 로 얻은 7자리 단지 ID"
    },
    "pyeong": {
      "type": "integer",
      "description": "평형(공급면적 평). 비우면 대표 평형"
    }
  },
  "required": [
    "danji_id"
  ],
  "additionalProperties": false
}

Recent recorded sale transactions (MOLIT data) for an apartment complex and floor-plan size, newest first. 단지·평형의 최근 3년 매매 실거래(계약일·가격·층·동·거래 유형·등기일)를 최근 계약순으로 돌려줍니다.

{
  "type": "object",
  "properties": {
    "danji_id": {
      "type": "string",
      "description": "search_apartments 로 얻은 7자리 단지 ID"
    },
    "pyeong": {
      "type": "integer",
      "description": "평형(공급면적 평). 비우면 대표 평형"
    },
    "limit": {
      "type": "integer",
      "description": "몇 건까지(기본 10, 최대 30)",
      "minimum": 1,
      "maximum": 30
    }
  },
  "required": [
    "danji_id"
  ],
  "additionalProperties": false
}

Apartment complex profile and per-size prices: households, completion date, builder, floor-area ratio, parking, and for each floor-plan size the Richgo estimated sale/jeonse price, latest recorded sale and current listings. 단지 개요(세대수·입주·시공사·용적률·주차)와 평형별 리치고 매매·전세 시세, 최근 실거래, 매물 수·호가 범위, 매물 소화 기간.

{
  "type": "object",
  "properties": {
    "danji_id": {
      "type": "string",
      "description": "search_apartments 로 얻은 7자리 단지 ID"
    }
  },
  "required": [
    "danji_id"
  ],
  "additionalProperties": false
}

Richgo's fair asking-price range by floor band (low/mid/high floors) for one floor-plan size, plus the quick-sale level. 평형의 층 구간별(저·중·고층) 리치고 적정 호가 추정 범위와 급매 수준, 기준 주, 매물 수. "이 가격 적당해?" 질문에 쓰세요.

{
  "type": "object",
  "properties": {
    "danji_id": {
      "type": "string",
      "description": "search_apartments 로 얻은 7자리 단지 ID"
    },
    "pyeong": {
      "type": "integer",
      "description": "평형. 비우면 대표 평형"
    }
  },
  "required": [
    "danji_id"
  ],
  "additionalProperties": false
}

This year's holding tax (property tax + comprehensive real estate tax) for one home of the given size, assuming a single-home owner-occupier, based on the official published price. 평형의 올해 1주택 실거주 보유세(재산세·종부세) — 고시 공시가격 기준, 리치고 세금 계산기와 같은 계산.

{
  "type": "object",
  "properties": {
    "danji_id": {
      "type": "string",
      "description": "search_apartments 로 얻은 7자리 단지 ID"
    },
    "pyeong": {
      "type": "integer",
      "description": "평형. 비우면 대표 평형"
    }
  },
  "required": [
    "danji_id"
  ],
  "additionalProperties": false
}

Monthly Richgo estimated sale and jeonse prices of an apartment complex size, with 1/3/5-year change and the peak. 단지·평형의 월별 리치고 매매·전세 시세 추이와 1·3·5년 변동률, 최고점 대비 위치를 돌려줍니다.

{
  "type": "object",
  "properties": {
    "danji_id": {
      "type": "string",
      "description": "search_apartments 로 얻은 7자리 단지 ID"
    },
    "pyeong": {
      "type": "integer",
      "description": "평형. 비우면 대표 평형"
    },
    "months": {
      "type": "integer",
      "description": "최근 몇 개월을 돌려줄지(기본 36, 최대 240)",
      "minimum": 1,
      "maximum": 240
    }
  },
  "required": [
    "danji_id"
  ],
  "additionalProperties": false
}

Apartment market of a province/district/neighborhood: Richgo price per pyeong and its rank, weekly/monthly/yearly change, jeonse ratio, recent transactions and listings, and the sub-regions ranked by price. 시도·시군구·읍면동의 아파트 평당 시세·순위·변동률(주·월·분기·연)·전세가율·거래량·매물 수와 하위 지역 시세 순위.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "description": "지역 이름 (예: 서울, 강남구, 대치동, 수원시 영통구)"
    },
    "bjd_code": {
      "type": "string",
      "description": "10자리 법정동 코드 (하위 지역을 이어 볼 때 결과의 bjd_code 를 그대로)"
    }
  },
  "additionalProperties": false
}

Nearest elementary, middle and high schools of an apartment complex with walking distance and the Richgo school-district rank within the province. 단지에서 가까운 초·중·고(거리순)와 시도 내 학군 순위, 학교 ID.

{
  "type": "object",
  "properties": {
    "danji_id": {
      "type": "string",
      "description": "search_apartments 로 얻은 7자리 단지 ID"
    },
    "per_level": {
      "type": "integer",
      "description": "학교급별 몇 곳(기본 3, 최대 5)",
      "minimum": 1,
      "maximum": 5
    }
  },
  "required": [
    "danji_id"
  ],
  "additionalProperties": false
}

School profile: type, students, teachers, province rank, admission results (special high schools for middle schools, university entrance for high schools, notable admissions), and nearby apartment complexes. 학교 상세 — 설립·학생 수·교사 수·시도 순위, 중학교는 특목·자사고 진학률, 고등학교는 대학 진학률·진학 실적, 주변 아파트.

{
  "type": "object",
  "properties": {
    "level": {
      "type": "string",
      "enum": [
        "elementary",
        "middle",
        "high"
      ],
      "description": "학교급"
    },
    "school_id": {
      "type": "string",
      "description": "get_school_district 로 얻은 학교 ID (예: S010000719)"
    }
  },
  "required": [
    "level",
    "school_id"
  ],
  "additionalProperties": false
}

Find redevelopment/reconstruction project sites near an apartment complex (within 1 km) or by name. 단지 주변 1km 안 재개발·재건축 사업지(거리순) 또는 이름으로 사업지를 찾아 site_id 를 돌려줍니다.

{
  "type": "object",
  "properties": {
    "danji_id": {
      "type": "string",
      "description": "이 단지 주변 사업지를 찾을 때 — search_apartments 로 얻은 단지 ID"
    },
    "query": {
      "type": "string",
      "description": "사업지 이름으로 찾을 때 (예: 전농9구역, 압구정3구역)",
      "maxLength": 40
    }
  },
  "additionalProperties": false
}

Detail of a redevelopment/reconstruction site: current stage, stage timeline with dates, Richgo AI expected approval month for the current stage, supply plan, permit history and, where published, the estimated member contribution basis. 사업지 상세 — 현재 단계·단계별 일정·AI 예상 통과월·공급 계획·인허가 이력·추정 분담금 자료.

{
  "type": "object",
  "properties": {
    "site_id": {
      "type": "string",
      "description": "search_redevelopment 로 얻은 사업지 ID (예: d7lHXyA)"
    },
    "previous_asset_manwon": {
      "type": "integer",
      "description": "추정 분담금 계산용 종전자산 평가액(만원, 예: 50000 = 5억). 비우면 원문 예시 기준만",
      "minimum": 1
    }
  },
  "required": [
    "site_id"
  ],
  "additionalProperties": false
}

In-progress Korean court auction items filtered by province/district, court or use type, nearest bidding date first. 시도·시군구·법원·용도로 진행 중 법원경매 물건을 찾습니다(매각기일 가까운 순): 감정가·최저매각가·유찰 횟수·매각기일.

{
  "type": "object",
  "properties": {
    "sd": {
      "type": "string",
      "description": "시도 축약형 (예: 서울, 경기, 부산)"
    },
    "sgg": {
      "type": "string",
      "description": "시군구 (예: 강서구, 창원시 의창구). sd 와 함께"
    },
    "court": {
      "type": "string",
      "description": "법원 전체 이름 (예: 서울남부지방법원)"
    },
    "category": {
      "type": "string",
      "enum": [
        "주거시설",
        "업무상업시설",
        "토지",
        "공업시설"
      ],
      "description": "용도 대분류"
    },
    "item_type": {
      "type": "string",
      "description": "용도 세분류 (예: 아파트, 다세대, 오피스텔)"
    },
    "limit": {
      "type": "integer",
      "description": "몇 건까지(기본 10, 최대 30)",
      "minimum": 1,
      "maximum": 30
    }
  },
  "additionalProperties": false
}

Public overview of one court auction item: case number, court, address, appraised/minimum price, failed rounds, bidding date, schedule history, appraisal notes and a rights summary (base right, assumed rights count). 경매 물건 개요 — 사건번호·법원·감정가·최저가·유찰·매각기일·진행 이력·감정평가 요약·말소기준권리와 인수 권리 건수.

{
  "type": "object",
  "properties": {
    "auction_id": {
      "type": "string",
      "description": "search_auctions 로 얻은 경매 물건 ID (예: C88PQDUZ)"
    }
  },
  "required": [
    "auction_id"
  ],
  "additionalProperties": false
}

Court auction statistics for the last 12 months in a province/district: number of auctions, sales, sale ratio and winning-bid-to-appraisal ratio, monthly and by property type. 전국·시도·시군구의 최근 12개월 경매 건수·매각 건수·매각률·매각가율(낙찰가÷감정가), 월별 추이와 용도별 합계.

{
  "type": "object",
  "properties": {
    "sd": {
      "type": "string",
      "description": "시도 축약형 (예: 서울). 비우면 전국"
    },
    "sgg": {
      "type": "string",
      "description": "시군구 (예: 강서구). sd 와 함께"
    }
  },
  "additionalProperties": false
}