KOSIS Korea Macro Indicators - 통계청 거시경제 지표
Pricing
Pay per usage
KOSIS Korea Macro Indicators - 통계청 거시경제 지표
Fetches Korea macro-economic indicators from Statistics Korea (KOSIS) API. Covers GDP, CPI, retail sales, unemployment, service production and 200+ economic indicators.
KOSIS Korea Macro Indicators
Fetch South Korea macro-economic indicators from Statistics Korea (KOSIS) OpenAPI. Collect GDP growth, CPI, unemployment, industrial production, retail sales, housing prices and more — all from the official government data source.
Features
- 7 preset indicators with correct KOSIS table codes
- Custom indicator support via
orgId:tblIdformat (access 200+ KOSIS tables) - Monthly or annual data
- Configurable date range
- Pay-per-event pricing — only pay for data you receive
Prerequisites
- Register at KOSIS OpenAPI (free)
- Apply for an API key (approved within 1–2 business days)
- Pass your key in the
api_keyinput field
Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
api_key | string | ✅ | — | KOSIS OpenAPI authentication key |
indicators | array | ✅ | ["cpi","unemployment"] | Preset keywords or orgId:tblId codes |
start_period | string | 12 months ago | Start period YYYYMM (monthly) or YYYY (annual) | |
end_period | string | Current month | End period YYYYMM or YYYY | |
period_type | string | monthly | monthly or annual | |
language | string | en | Output language for indicator names: en or kr |
Preset Indicators
| Keyword | Indicator | Source Table |
|---|---|---|
gdp | GDP Growth Rate | 301 / DT_200Y003 |
cpi | Consumer Price Index | 101 / DT_1J20006 |
retail_sales | Retail Sales Index | 101 / DT_1L9H001 |
unemployment | Unemployment Rate | 101 / DT_1DA7002S |
service_production | Service Production Index | 101 / DT_1L9H002 |
industrial_production | Industrial Production Index | 101 / DT_1L9B001 |
housing_price | Housing Price Index | 408 / DT_KAB_12001_S1 |
Custom Indicators
Pass any KOSIS table using the orgId:tblId format:
{"indicators": ["101:DT_1DA7002S", "301:DT_200Y003"]}
Browse available tables at KOSIS Statistical DB.
Output Fields
Each dataset item contains:
| Field | Description |
|---|---|
indicator_key | Preset keyword or raw code |
indicator_name | Human-readable indicator name |
item_name | KOSIS item sub-classification name |
classification | KOSIS classification code (C1) |
period | Period string (YYYYMM or YYYY) |
value | Numeric value (null if not available) |
unit | Unit (%, index, etc.) |
org_id | KOSIS organization ID |
tbl_id | KOSIS table ID |
source | Always "KOSIS - Statistics Korea" |
Example Output
{"indicator_key": "cpi","indicator_name": "Consumer Price Index","item_name": "총지수","classification": "","period": "202412","value": 115.7,"unit": "index","org_id": "101","tbl_id": "DT_1J20006","source": "KOSIS - Statistics Korea"}
Pricing
| Event | Price |
|---|---|
| Actor start | $0.001 |
| Per data point returned | $0.001 |
Fetching 7 indicators over 12 months typically returns 80–100 data points (~$0.10).
Data Source
All data is sourced from Statistics Korea (KOSIS), the official statistical portal of the Korean government.
Legal
This Actor retrieves publicly available data via the official KOSIS OpenAPI under the 공공데이터 이용허락 terms. Use of this Actor is subject to the KOSIS API terms of service.
Keywords: KOSIS, South Korea macroeconomics, GDP, CPI, unemployment, Statistics Korea, Korean economy, economic indicators, macro data