get_statistics_data
Fetch actual statistical data from KOSIS by table ID, organization, and date range. Get a summary with metadata, pivot, and preview, or request raw data.
Instructions
KOSIS에서 통계 데이터를 조회합니다.
search_statistics나 get_table_metadata로 확인한 테이블의 실제 데이터를 가져옵니다.
Args:
org_id: 기관 ID (예: "101")
tbl_id: 테이블 ID (예: "DT_1B040A3")
start_date: 시작 기간 (예: "2019", "202301")
end_date: 종료 기간 (예: "2023", "202312")
prd_se: 기간 유형
"Y"=연간, "M"=월간, "Q"=분기, "S"=반기
format: 응답 형식
"summary" (기본): LLM 친화적 요약 형식 (메타데이터 + 피벗 요약 + 샘플)
"raw": 전체 원본 데이터 (주의: 컨텍스트 초과 가능)
new_est_prd_cnt: 최근 N개 시점만 반환 (선택). KOSIS newEstPrdCnt 매핑.
예: 5 → 가장 최근 5개 기간만. start_date/end_date를 자동
제한하므로 "최근 5년만" 같은 자연어 쿼리에 직접 사용.
prd_interval: 기간 stride (선택). KOSIS prdInterval 매핑.
예: prd_se="Y" + prd_interval=2 → 격년 데이터.
Returns: format="summary" (기본): { "summary": { "total_records": 850, "period_range": "2019~2023", "dimensions": ["행정구역별"], "items": ["인구수"] }, "metadata": { "tbl_id": "DT_1B040A3", "tbl_nm": "행정구역별 인구수", "org_nm": "통계청", "unit": "명" }, "pivot_summary": { "by_period": {"2019": 51849861, "2023": 51558034}, "by_c1": {"경기도": 68123456, "서울특별시": 47056789, ...} }, "data_preview": [최근 기간 샘플 50건], "available_values": { "PRD_DE": ["2019", "2020", "2021", "2022", "2023"], "C1_NM": ["서울특별시", "부산광역시", ...] } }
format="raw": 전체 API 응답 (배열 형태)Example: >>> get_statistics_data("101", "DT_1B040A3", "2019", "2023") >>> get_statistics_data("101", "DT_1B040A3", "2019", "2023", format="raw")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| format | No | summary | |
| org_id | Yes | ||
| prd_se | No | Y | |
| tbl_id | Yes | ||
| end_date | Yes | ||
| start_date | Yes | ||
| prd_interval | No | ||
| new_est_prd_cnt | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |