Service
Monthly resident-registration population and household counts for Korean provinces and districts, sourced from the Ministry of the Interior and Safety's resident-registration population and household (주민등록 인구·세대) dataset on data.go.kr.
37.04%30-day uptimeAvg response32068ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-population/population-by-region | Returns 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-demographics | Lists 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. |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
Observed on this service over the last 30 days.
