APIFuseAPIFuse
문서서비스플레이그라운드상태
로그인회원가입

Service

Korea Population

한국, 라이프스타일제공 중
Playground에서 시험API 레퍼런스 열기

Overview

data.go.kr에 공개된 행정안전부 주민등록 인구·세대 데이터셋을 기반으로 한 시·도 및 시·군·구별 월간 주민등록 인구와 세대수.

Status

중단

37.29%30일 가동률평균 응답34534ms

2026-09-142026-10-112026-10-25

Setup

Auth mode
Managed key
Credentials
  • korea-population scope가 허용된 managed key
Sandbox
미제공

APIs

행을 선택하면 해당 API의 레퍼런스로 이동합니다.

MethodAPIPathSummary
POST/v1/korea-population/population-by-regionReturns resident-registration population rows (population, households, male/female split) for one Korean province for a given year and month, optionally narrowed to one district by its exact name. Use when the user asks for the population, household count, or male/female breakdown of a specific province or district in a specific month; this is the preferred operation. korea-population:resident-demographics is an equivalent alias with the same input and output, so do NOT switch to it expecting different results. Do NOT use for multi-month trends or projections — each call covers exactly one month. Do NOT use for months before October 2022, which is the first month this dataset publishes. A province-wide query reads every district of the province and every page of every district, so the rows are the complete province and never a first page; if a query is too large for the fixed upstream request budget it is refused outright rather than answered with part of the province. Returns items, one row per district — there is no province-total row, so sum the rows if you need one.
POST/v1/korea-population/resident-demographicsLists resident-registration demographic rows (population, households, male/female split) for one Korean province for a given year and month, optionally narrowed to one district by its exact name. This is an equivalent alias of korea-population:population-by-region with identical input, output, and behavior. Use only when korea-population:population-by-region is unavailable; otherwise prefer that operation. Do NOT use for multi-month trends or projections — each call covers exactly one month. Do NOT use for months before October 2022, which is the first month this dataset publishes. A province-wide query reads every district of the province and every page of every district, so the rows are the complete province and never a first page; if a query is too large for the fixed upstream request budget it is refused outright rather than answered with part of the province. Returns items, one row per district — there is no province-total row, so sum the rows if you need one.

Related guides

  • sandbox key를 발급받고 첫 예약 생성까지 진행합니다.

  • 파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.

  • 예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.

  • 서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.

지역별 인구 조회
주민등록 인구 통계 조회
빠른 시작
Managed key
개요
에러 모델