지역 데이터, 그대로 가져가세요.
인증 없는 읽기 전용 API입니다. GPT 도구 연결, 지역 비교, 셀프 인테리어 콘텐츠의 근거 자료로 사용할 수 있습니다. 개인 정보나 계산기 입력값은 제공하지 않습니다.
자료 출처·시점
원출처: 행정안전부 주민등록 인구통계. ROBOTION 자체 DB의 public_population_region 지역별 집계를 공개 전용 SQLite DB에 복제합니다. 외부 요청은 원본 운영 DB를 조회하지 않습니다.
최신 보유 기준월: 202605 · 지역 3,913개 · 공개 DB 반영: 2026-09-05T20:45:53+00:00.
매일 동기화하되 원본 DB에 새 자료가 없으면 기준월은 유지합니다. 수집일·반영일을 관측 기준월로 바꾸지 않습니다. 원출처 이용 조건을 확인하고 출처·기준월을 함께 표기하세요. 공공 원자료의 이용 조건을 문고리닷컴이 변경하거나 별도 권리를 부여하지 않습니다.
API 호출
GET https://www.mungori.com/interior-data/api.php?q=강남구 GET https://www.mungori.com/interior-data/api.php?code=1168000000 GET https://www.mungori.com/interior-data/api.php?parent=1100000000 GET https://www.mungori.com/interior-data/api.php?level=2&month=202605 GET https://www.mungori.com/interior-data/api.php?format=csv&limit=1000
파라미터: q(지역명, 공백은 AND), code(10자리 지역코드), parent(직속 상위 코드), level(0 전국 / 1 시도 / 2 시군구 / 3 읍면동), month(YYYYMM, 생략 시 보유 최신), format(json/csv), limit(1~1,000, 기본 1,000), offset(기본 0).
조건은 AND로 결합합니다. JSON 응답의 next URL이 null이 될 때까지 따라가면 전체를 가져옵니다. CSV는 한 번에 최대 1,000행이며 다음 페이지는 HTTP Link 헤더에 있습니다. CSV 지역코드는 엑셀에서 텍스트 형식으로 불러오세요(전국 코드의 앞자리 0 보존).
GET·HEAD만 허용, CORS 공개, 5분 캐시, ETag 조건부 요청 지원. HTTP 400은 잘못된 조건, 404는 미보유 기준월, 405는 미지원 메서드, 503은 일시적인 데이터 준비 상태입니다. 검색 결과가 없으면 200과 빈 data 배열을 반환합니다.
필드 사전
| 필드 | 의미 |
|---|---|
base_ym | 관측 기준월 YYYYMM (월말 기준) |
region_cd / parent_cd | 지역 / 직속 상위 행정기관코드. 문자열, 전국의 부모는 null |
level / region_nm | 행정 단계 / 원자료 지역명 |
pop / male / female | 총 / 남 / 여 주민등록 인구, 명 |
young14 / adult / old65 | 0~14세 / 25~64세 / 65세 이상 인구, 명 |
young14_pct / adult_pct / old65_pct | 연령대 인구 ÷ 총인구 × 100, 소수 둘째 자리, 인구 0은 null |
avg_age | 원본 DB 가중 평균 나이. 100세 이상은 100으로 근사, CSV는 생략 |
keywords | 지역명 + 주제의 편집 조합. 실제 검색량이나 인기 순위가 아님 |
url | 지역별 관측값을 확인·인용할 페이지 |
metadata.db_imported_at | 공개 DB 반영 UTC 일시. 관측 날짜가 아님 |
metadata.sha256 | 공개 대상 원본 스냅샷 행 묶음의 해시. 응답 파일 자체 해시가 아님 |
해석과 합산 시 주의
- 시도·시군구·읍면동은 서로 중복됩니다. 통합시와 소속 구가 모두 level=2에 있을 수도 있습니다. level만 같다고 합산하지 마세요. 전국 총인구는 코드 0000000000의 pop을 쓰세요.
- 주민등록 인구는 거주자·거주불명자·재외국민을 포함하며 외국인은 제외됩니다. 주택 수나 가구 수로 바꾸어 해석하지 마세요.
- 비율을 단순 평균하지 마세요. 서로 겹치지 않는 지역을 확인한 뒤 인구수를 합산하고 분모도 합산해야 합니다.
- 0~14세, 25~64세, 65세 이상은 일부 연령 구간이므로 합계가 100%가 아닙니다.
- 지역별 공사 수요, 실제 시공비, 검색량, 구매 확률은 이 데이터에 없습니다. 타일 수량 예시는 사용자가 입력한 실측값과 여유율의 산식이지 지역 통계가 아닙니다.
- 현재 기준월이 하나뿐이면 증감률·시계열 추세는 계산할 수 없습니다. 동기화 실패 시 이전 검증 자료를 유지합니다.
GPT에서 사용하는 방법
도구/API 연결을 지원하는 환경에서는 위 OpenAPI 명세의 searchRegionalInteriorData를 읽기 도구로 연결하세요. 브라우징에서는 지역 페이지 URL을 전달할 수 있습니다. 이 공개 설정이 모든 GPT 대화에서의 자동 수집이나 검색 노출을 보장하지는 않습니다.
문고리닷컴 지역 데이터 API에서 서울 강남구를 조회해 줘. 기준월, 총인구, 65세 이상 비율, 출처 URL을 포함해 설명하고, 공사 수요·시공비로 추정하지 말아 줘.
인용 예: “문고리닷컴 지역 데이터, 행정안전부 주민등록 인구통계 기반, 202605 기준, 해당 지역 페이지 URL, 조회일.”