공개 집계 API
누구집(nuguzip.com)은 국토교통부 실거래 신고 자료로 만든 아파트 매매 월간 지역 집계를 인증 없이 JSON 으로 제공합니다. 사이트 화면에 이미 공개된 수치와 같은 값이며, 출처를 표기하면 누구나 쓸 수 있습니다.
시작하기
키 발급도 등록도 없습니다. 아래 한 줄이면 최신 월의 집계가 나옵니다.
curl "https://nuguzip.com/api/public/v1/regions/monthly?limit=5"기본 주소: https://nuguzip.com/api/public/v1 · 응답은 UTF-8 JSON · IP 당 분당 120회
엔드포인트
/api/public/v1API 목차
제공 중인 엔드포인트와 파라미터, 호출 한도를 JSON 으로 돌려줍니다. 이 문서를 읽지 않아도 여기서 나머지를 찾을 수 있습니다.
curl https://nuguzip.com/api/public/v1/api/public/v1/months집계가 존재하는 월 목록
월별로 집계된 지역 수와 총 거래 건수를 최신순으로 돌려줍니다. 어느 구간을 요청할 수 있는지 먼저 확인하는 자리입니다.
curl https://nuguzip.com/api/public/v1/months/api/public/v1/regions/monthly지역×월 집계
시군구 단위 월간 집계입니다. 거래 건수, 평균 거래가, 평당가, 전월 대비 변동률을 포함합니다.
month— yyyymm 6자리. 생략하면 전체 월을 최신순으로 반환합니다.region— 지역명 부분 일치. 예: region=강남limit— 1~500 (기본 100)offset— 0 이상. 응답의 total·hasMore 로 다음 페이지 여부를 판단합니다.
curl "https://nuguzip.com/api/public/v1/regions/monthly?month=202605®ion=강남&limit=20"응답 필드
regionCode— 법정동 코드 앞 5자리(시군구)regionName— 국토교통부 신고 자료 표기 그대로의 지역명month— 집계 기준월 (yyyymm)transactionCount— 해당 월 신고된 매매 건수 (해제 신고분 제외)avgDealAmountKrw— 평균 거래금액(원). 면적·층 가중 없는 단순 평균avgPricePerPyeongKrw— 평당 평균가(원)trendDeltaPct— 전월 대비 평균 거래가 변동률(%)updatedAt— 이 행이 마지막으로 갱신된 시각(ISO 8601)provisional— true 이면 신고 지연으로 아직 값이 늘어날 수 있는 달(이번 달·직전 달)입니다license— 출처·인용 조건. 모든 응답 본문에 함께 실립니다
상태 코드
200— 정상. 조건에 맞는 행이 하나도 없으면 rows 가 빈 배열이며, 이는 “그 조건의 데이터가 없다”는 사실입니다.400— 요청이 잘못됐습니다. 무엇이 왜 틀렸는지 error.message 와 error.hint 에 적습니다.429— 호출 한도 초과. Retry-After 를 참고해 다시 시도해 주세요.503— 저희가 조회에 실패했습니다. 데이터가 없다는 뜻이 아닙니다. 잠시 후 다시 호출하면 성공할 수 있습니다.
인용 조건
출처를 표기하면 상업적 이용을 포함해 자유롭게 쓸 수 있습니다. 같은 내용이 모든 응답의 license 필드에도 실려 있어, 문서를 보지 않고 API 만 쓴 경우에도 출처가 함께 이동합니다.
집계 방식과 한계는 데이터 방법론에 적혀 있습니다. 평균은 면적·층을 가중하지 않은 단순 평균이며, 최근 1~2개월 수치는 신고 지연으로 계속 늘어납니다 — 인용하실 때 함께 밝혀 주세요.
자주 묻는 질문
인증 키가 필요한가요?
필요 없습니다. 인증 없이 GET 으로 호출할 수 있고 CORS 가 열려 있어 브라우저에서 바로 부를 수 있습니다. 대신 IP 당 분당 120회 제한이 있으며, 초과하면 429 를 반환합니다.
데이터를 어디까지 공개하나요?
국토교통부 실거래 신고 자료로 만든 아파트 매매(trade/apartment)의 시군구×월 집계만 공개합니다. 개별 실거래 행(단지·동·층·계약일 단위), 전월세 집계, 이용자가 작성한 임장노트·회원·모임 데이터는 API 에 포함되지 않습니다. 화면에 공개되지 않은 것을 API 로 먼저 열지 않는다는 원칙입니다.
조회에 실패하면 어떤 응답이 오나요?
빈 배열이 아니라 503 과 error.code=upstream_unavailable 이 옵니다. "데이터가 없다"와 "조회가 실패했다"는 다른 사실이고, 실패를 빈 값으로 돌려주면 받아 간 쪽이 "그 달에 거래가 없었다"고 잘못 인용하게 되기 때문입니다. 요청 자체가 잘못된 경우(월 형식 오류 등)는 400 과 함께 무엇이 왜 틀렸는지 적어 보냅니다.
최근 달 거래 건수가 유난히 적은데 맞나요?
실거래 신고 기한이 계약일로부터 30일이라 이번 달과 직전 달은 아직 채워지는 중입니다. 해당 행에는 provisional: true 가 붙습니다. 이 값으로 "거래가 급감했다"고 해석하면 안 됩니다.
얼마나 자주 갱신되나요?
수집 크론이 하루 두 번(한국시간 09:00·18:00 전후) 돌고 그 뒤 집계를 갱신합니다. 응답은 CDN 에서 최대 1시간 캐시되며, 각 행의 updatedAt 으로 실제 갱신 시각을 확인할 수 있습니다.
상업적으로 써도 되나요?
출처를 표기하면 상업적 이용을 포함해 자유롭게 쓸 수 있습니다. 원자료는 국토교통부 공개 자료이고, 누구집은 그 위의 집계를 제공합니다. 표기 예: "누구집(nuguzip.com) 집계, 국토교통부 실거래 기반, 2026년 5월 기준". 다만 집계 방식의 한계(단순 평균·신고 지연)를 함께 밝혀 주시기를 권합니다.
엔드포인트가 바뀔 수도 있나요?
경로에 v1 이 들어 있습니다. 필드를 추가하는 변경은 v1 안에서 하지만, 기존 필드의 이름·의미를 바꾸거나 없애는 변경은 v2 로 분리합니다. 중단이 필요하면 이 페이지에 먼저 공지합니다.