주민등록 인구 기반 육아세대 추정 API API

#주민등록#세대#추정

업데이트 : 2026-05-12

세대주 연령·자녀 유무 등 행정 통계를 조합해 육아 가능 세대 규모를 추정하는 보조 지표를 제공합니다. (실제 수치는 목업 예시입니다.)

Endpoint

데모 버전	https://development.fitples.example/v1/statistics/mois-resident-1
정식 버전	https://api.fitples.example/v1/statistics/mois-resident-1

Timeout

300

입력부(Input)

Key	Name	Type	Required	Description
organization	기관코드	String	O	연계 기관 식별 코드 (목업: 0001)
apiKey	API Key	String	O	발급받은 Bearer 토큰 또는 쿼리 파라미터
regionCode	지역코드	String	△	시·도 또는 시·군·구 코드 (선택)
page	페이지	Number	△	페이지 번호 (기본 1)
size	페이지크기	Number	△	1회 조회 건수 (기본 20, 최대 100)

입력부

{
  "organization": "0001",
  "apiKey": "fp_test_****************",
  "regionCode": "11",
  "page": 1,
  "size": 20
}

입력부 특이사항

· 본 문서는 Fitples 카탈로그용 목업입니다. · 실제 인증·동의·암호화 방식은 정식 오픈 시 별도 가이드로 제공됩니다.

출력부(Output)

단건의 경우 객체형, 다건의 경우 리스트형으로 반환됩니다. (목업 예시)

Key	Name	Type	Required	Description
resultCode	결과코드	String	O	CF-0000 성공 기준 (목업)
data	응답 본문	Object	O	조회 결과 객체
res_mois-resident-1_0	세대주연령	String	O	[세대] 항목
res_mois-resident-1_1	자녀수	String	O	[세대] 항목
res_mois-resident-1_2	지역	String	△	[세대] 항목
res_mois-resident-1_3	추정점수	String	△	[세대] 항목
res_mois-resident-1_4	기준일	String	△	[출처] 항목
res_mois-resident-1_5	집계버전	String	△	[출처] 항목
meta	메타	Object	O	요청 ID, 캐시 여부 등
requestId	요청 ID	String	O	추적용 UUID

출력부

{
  "resultCode": "CF-0000",
  "data": {
    "items": [
      {
        "id": "ROW-1",
        "label": "세대주연령",
        "group": "세대",
        "value": "***"
      },
      {
        "id": "ROW-2",
        "label": "자녀수",
        "group": "세대",
        "value": "***"
      },
      {
        "id": "ROW-3",
        "label": "지역",
        "group": "세대",
        "value": "***"
      },
      {
        "id": "ROW-4",
        "label": "추정점수",
        "group": "세대",
        "value": "***"
      }
    ],
    "totalCount": 128
  },
  "meta": {
    "requestId": "req_mock_7c21",
    "cached": false
  }
}

출력부 특이사항

· 단건은 객체, 목록은 배열 형태로 반환되는 것을 가정한 예시입니다. · 필드명·타입은 실제 스키마와 다를 수 있습니다.