연령별 육아 가구 인구 통계 API API

#육아#인구#시계열

업데이트 : 2026-05-12

영·유아 동반 가구 수, 지역·연령대별 분포 등 육아 관련 인구 통계를 시계열로 조회합니다. 대시보드·정책 시뮬레이션에 활용할 수 있습니다.

Endpoint

데모 버전	https://development.fitples.example/v1/statistics/child-pop-1
정식 버전	https://api.fitples.example/v1/statistics/child-pop-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_child-pop-1_0	기준연월	String	O	[집계] 항목
res_child-pop-1_1	시도코드	String	O	[집계] 항목
res_child-pop-1_2	연령대	String	△	[집계] 항목
res_child-pop-1_3	가구수	String	△	[집계] 항목
res_child-pop-1_4	전년대비	String	△	[집계] 항목
res_child-pop-1_5	통계표ID	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
  }
}

출력부 특이사항

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