아파트 데이터를 코드로 다루세요

https://api-m.richgo.ai

# 인증
POST /v2/Authen/partner/token
POST /v2/Authen/partner/token/refresh

# 단지 찾기
GET  /v2/Partner/danji

# 단지 데이터
GET  /v2/Partner/danji/{danjiId}
GET  /v2/Partner/danji/{danjiId}/trades
GET  /v2/Partner/danji/{danjiId}/schools
GET  /v2/Partner/danji/{danjiId}/goodnews
GET  /v2/Partner/danji/{danjiId}/region-stats
GET  /v2/Partner/danji/{danjiId}/opengoods-stats
GET  /v2/Partner/danji/{danjiId}/nearby-infra

# 1) 토큰 발급
TOKEN=$(curl -s -X POST "https://api-m.richgo.ai/v2/Authen/partner/token" \
  -H "Content-Type: application/json" \
  -d '{"apiKey":"rgk_...","apiSecret":"..."}' \
  | jq -r '.accessToken')

# 2) 단지 찾기 → danjiId
DANJI=$(curl -s -G "https://api-m.richgo.ai/v2/Partner/danji" \
  --data-urlencode "sgg=광진구" \
  --data-urlencode "name=더샵스타시티" \
  -H "Authorization: Bearer $TOKEN" \
  | jq -r '.items[0].danjiId')

# 3) 단지 조회
curl -s "https://api-m.richgo.ai/v2/Partner/danji/$DANJI" \
  -H "Authorization: Bearer $TOKEN" | jq '.'

import requests

BASE = "https://api-m.richgo.ai"

# 1) 토큰 발급
res = requests.post(
    f"{BASE}/v2/Authen/partner/token",
    json={"apiKey": "rgk_...", "apiSecret": "..."},
    timeout=10,
)
res.raise_for_status()
token = res.json()["accessToken"]
headers = {"Authorization": f"Bearer {token}"}

# 2) 단지 찾기 → danjiId
res = requests.get(
    f"{BASE}/v2/Partner/danji",
    params={"sgg": "광진구", "name": "더샵스타시티"},
    headers=headers, timeout=10,
)
danji_id = res.json()["items"][0]["danjiId"]

# 3) 단지 조회
res = requests.get(
    f"{BASE}/v2/Partner/danji/{danji_id}",
    headers=headers, timeout=10,
)
danji = res.json()
print(danji["danjiName"], danji["totalHouseholds"])

const BASE = "https://api-m.richgo.ai";

// 1) 토큰 발급
const auth = await fetch(`${BASE}/v2/Authen/partner/token`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ apiKey: "rgk_...", apiSecret: "..." }),
});
const token = await auth.json();
const headers = { Authorization: `Bearer ${token.accessToken}` };

// 2) 단지 찾기 → danjiId
const query = new URLSearchParams({ sgg: "광진구", name: "더샵스타시티" });
const found = await fetch(`${BASE}/v2/Partner/danji?${query}`, { headers });
const search = await found.json();
const danjiId = search.items[0].danjiId;

// 3) 단지 조회
const res = await fetch(`${BASE}/v2/Partner/danji/${danjiId}`, { headers });
const danji = await res.json();
console.log(danji.danjiName, danji.totalHouseholds);

import time, requests

_cache = {"token": None, "exp": 0}

def get_token():
    # 만료 5분 전에 미리 갱신한다
    if _cache["token"] and time.time() < _cache["exp"] - 300:
        return _cache["token"]

    r = requests.post(
        "https://api-m.richgo.ai/v2/Authen/partner/token",
        json={"apiKey": API_KEY, "apiSecret": API_SECRET},
        timeout=10,
    )
    r.raise_for_status()
    data = r.json()

    _cache["token"] = data["accessToken"]
    _cache["exp"] = time.time() + data["expiresIn"]
    return _cache["token"]

{
  "danjiId": "a9rJSEi",
  "danjiName": "한화포레나포항",
  "constructYear": 2024,
  "constructDate": "2024-03-01T00:00:00+09:00",
  "buildingAgeYears": 3,
  "totalHouseholds": 2192,
  "floorTop": 30,
  "constructName": "(주)한화"
}

{
  "error": "NOT_FOUND",
  "message": "해당 단지 정보를 찾을 수 없습니다."
}

HTTP/1.1 429 Too Many Requests
Retry-After: 1
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9863
X-RateLimit-Reset: 41820

{
  "error": "RATE_LIMIT_EXCEEDED",
  "message": "초당 호출 한도를 초과했습니다."
}

def call(path, retries=3):
    for attempt in range(retries):
        r = requests.get(
            BASE + path,
            headers={"Authorization": f"Bearer {get_token()}"},
            timeout=10,
        )
        if r.status_code != 429:
            r.raise_for_status()
            return r.json()

        wait = int(r.headers.get("Retry-After", 1))
        time.sleep(wait)

    raise RuntimeError("호출 한도 초과")

curl -X POST "https://api-m.richgo.ai/v2/Authen/partner/token" \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "rgk_xxxxxxxxxxxxxxxx",
    "apiSecret": "xxxxxxxxxxxxxxxx"
  }'

{
  "accessToken": "eyJhbGciOiJIUzI1NiIs...",
  "refreshToken": "eyJhbGciOiJIUzI1NiIs...",
  "expiresIn": 86400,
  "issuedAt": 1754438400000,
  "accessTokenExpiresAt": 1754524800000,
  "refreshTokenExpiresAt": 1755734400000
}

curl -X POST \
  "https://api-m.richgo.ai/v2/Authen/partner/token/refresh" \
  -H "Authorization: Bearer $REFRESH_TOKEN"

# 단지명으로
curl -G "https://api-m.richgo.ai/v2/Partner/danji" \
  --data-urlencode "sgg=광진구" \
  --data-urlencode "name=더샵" \
  -H "Authorization: Bearer $TOKEN"

# 법정동 전체 목록
curl -G "https://api-m.richgo.ai/v2/Partner/danji" \
  --data-urlencode "bjdCode=1121510500" \
  --data-urlencode "size=100" \
  -H "Authorization: Bearer $TOKEN"

{
  "totalCount": 1,
  "page": 1,
  "size": 20,
  "items": [
    {
      "danjiId": "a4BVkni",
      "danjiName": "더샵스타시티",
      "sd": "서울",
      "sgg": "광진구",
      "emd": "자양동",
      "bjdCode": "1121510500",
      "address": "서울시 광진구 자양동 227-7",
      "totalHouseholds": 1177,
      "constructYear": 2007
    }
  ]
}

curl "https://api-m.richgo.ai/v2/Partner/danji/a4BVkni" \
  -H "Authorization: Bearer $TOKEN"

{
  "danjiId": "a4BVkni",
  "danjiName": "더샵스타시티",
  "constructYear": 2007,
  "totalHouseholds": 1177,
  "floorTop": 35,
  "floorBot": 1,
  "totalParking": 2130,
  "floorAreaRatio": 376,
  "buildingCoverageRatio": 32,
  "constructName": "포스코건설"
}

# 기본 (최근 24개월, 전 평형)
curl "https://api-m.richgo.ai/v2/Partner/danji/a4BVkni/trades" \
  -H "Authorization: Bearer $TOKEN"

# 최근 5년 + 34평만
curl "https://api-m.richgo.ai/v2/Partner/danji/a4BVkni/trades?months=60&pyeongType=34" \
  -H "Authorization: Bearer $TOKEN"

{
  "danjiId": "a4BVkni",
  "danjiName": "더샵스타시티",
  "months": 24,
  "totalCount": 71,
  "items": [
    {
      "tradeDate": "2026-07-18T00:00:00",
      "pyeongType": 34,
      "price": 180000,
      "floor": 17,
      "supplyArea": 114.8,
      "privateArea": 84.9,
      "dong": "101",
      "transactionType": "매매"
    }
  ]
}

curl "https://api-m.richgo.ai/v2/Partner/danji/a4BVkni/schools?top=3" \
  -H "Authorization: Bearer $TOKEN"

{
  "danjiId": "a4BVkni",
  "danjiName": "더샵스타시티",
  "elementarySchools": [
    {
      "schoolId": "S010002176",
      "schoolName": "서울동자초등학교",
      "schoolLevel": "초등학교",
      "foundationType": "공립",
      "distanceEuclidean": 300.7,
      "totalStudent": 946,
      "studentPerTeacher": 16.89,
      "admissionRate": 10.19,
      "baseYear": 2026
    }
  ],
  "middleSchools": [ /* ... */ ],
  "highSchools": [ /* ... */ ]
}

# 반경 1km (기본)
curl "https://api-m.richgo.ai/v2/Partner/danji/a4BVkni/goodnews" \
  -H "Authorization: Bearer $TOKEN"

# 반경 300m 이내만
curl "https://api-m.richgo.ai/v2/Partner/danji/a4BVkni/goodnews?maxDistance=300" \
  -H "Authorization: Bearer $TOKEN"

{
  "danjiId": "a4BVkni",
  "danjiName": "더샵스타시티",
  "maxDistance": 1000,
  "summary": {
    "goodnewsScore": 5,
    "totalCount": 7,
    "trafficCount": 0,
    "houseCount": 6,
    "jiguCount": 0,
    "etcCount": 1,
    "houseRegionMean": 1.48584
  },
  "items": [
    {
      "goodnewsId": "d8AxKJU",
      "type": "주택",
      "subType": "재개발",
      "name": "자양동 227-147",
      "score": 4,
      "distance": 163.7,
      "distanceGroup": 300
    }
  ]
}

curl "https://api-m.richgo.ai/v2/Partner/danji/a4BVkni/region-stats" \
  -H "Authorization: Bearer $TOKEN"

{
  "danjiId": "a4BVkni",
  "danjiName": "더샵스타시티",
  "sd": "서울특별시",
  "sgg": "광진구",
  "transactionVolume12m": 1284,
  "opengoodsVolume12m": 3921,
  "housingHouseholds36m": 1508
}

curl "https://api-m.richgo.ai/v2/Partner/danji/a4BVkni/opengoods-stats" \
  -H "Authorization: Bearer $TOKEN"

curl "https://api-m.richgo.ai/v2/Partner/danji/a4BVkni/nearby-infra?top=5" \
  -H "Authorization: Bearer $TOKEN"

curl "https://api-m.richgo.ai/v2/Partner/danji/a9rJSEi/ai-price?pyeongType=33" \n  -H "Authorization: Bearer $TOKEN"

curl "https://api-m.richgo.ai/v2/Partner/danji/a9rJSEi/price-series?pyeongType=33&months=36" \n  -H "Authorization: Bearer $TOKEN"

curl -G "https://api-m.richgo.ai/v2/Partner/region/heatmap" \n  --data-urlencode "sd=경북" \n  --data-urlencode "sgg=포항시 북구" \n  -H "Authorization: Bearer $TOKEN"

curl -X POST "https://api-m.richgo.ai/v2/Partner/deposit-safety" \n  -H "Authorization: Bearer $TOKEN" \n  -H "Content-Type: application/json" \n  -d '{"danjiId":"a9rJSEi","pyeongType":33,"deposit":20000,
       "seniorDebt":0,"juniorDebt":0,"hasAdverseRegistryEntry":false}'

# 연동 가이드
curl -O "https://m.richgo.ai/developers/richgo-integration.md"

# React 컴포넌트
curl -O "https://m.richgo.ai/developers/richgo-partner-ui-react.zip"
unzip richgo-partner-ui-react.zip

# 타입 체크
cd richgo-partner-ui
npm i && npm run typecheck

# 출처
- 실거래가는 국토교통부 신고 자료 기준
- 학군·호재는 참고 자료이며
  법적 효력이 있는 자료가 아님

# 갱신
- 실거래가: 국토부 공개 주기를 따름
- 학군: 매년 2~4월 갱신
- 호재: 사업 단계 변동 시 갱신