KOSIS Korea Macro Indicators - 통계청 거시경제 지표

What does KOSIS Korea Macro Indicators do?

KOSIS Macro Indicators is a Korea statistics API client that fetches official South Korean macroeconomic data directly from the Statistics Korea (KOSIS) OpenAPI. Specify indicators such as GDP growth, CPI, unemployment, or industrial production, set a date range, and the actor returns clean, structured time-series records from the authoritative Korean government source. It supports both preset indicator shortcuts and raw orgId:tblId table codes for access to 200+ KOSIS datasets.

Why use KOSIS Macro Indicators?

Direct access to official Korean economic data — no scraping, no re-sellers. KOSIS is the primary statistical portal of the Korean government and is the definitive source for all major Korean economic data releases:

• Macro research and forecasting — build econometric models using GDP, CPI, unemployment, and retail sales data sourced directly from the government rather than third-party data vendors.
• Korea-focused investment analysis — track KOSIS macro indicators to time sector exposure across Korean equities, bonds, and currency positions.
• Central bank and policy monitoring — monitor leading indicators (industrial production, housing prices, service output) to anticipate Bank of Korea monetary policy shifts before consensus.
• Data journalism and academic research — access decades of official Korean economic time-series data with clear provenance for citations and reproducibility.
• Cross-country macro comparison — combine Korean indicator data with other country feeds (OECD, FRED) to build comparative dashboards and emerging-market screening models.

How to use KOSIS Macro Indicators

1. Register for a free KOSIS OpenAPI key at kosis.kr/openapi — approval takes 1–2 business days.
2. Open the actor on Apify and enter your api_key.
3. Set the indicators array using preset keywords (e.g. ["cpi", "gdp", "unemployment"]) or raw KOSIS table codes.
4. Set start_period and end_period in YYYYMM format for monthly data (or YYYY for annual).
5. Choose period_type (monthly or annual) and language (en or kr).
6. Click Run — results appear in the dataset within seconds.

Input

Field	Type	Required	Default	Description
api_key	string	Yes	—	KOSIS OpenAPI authentication key
indicators	array	Yes	["cpi","unemployment"]	Preset keywords or orgId:tblId codes
start_period	string	No	12 months ago	Start period YYYYMM (monthly) or YYYY (annual)
end_period	string	No	Current month	End period YYYYMM or YYYY
period_type	string	No	monthly	monthly or annual
language	string	No	en	Output language for indicator names: en or kr

Preset indicator keywords available out of the box:

Keyword	Indicator	KOSIS 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

For any other KOSIS table, pass "orgId:tblId" directly (e.g. "101:DT_1DA7002S"). Browse the full catalog at KOSIS Statistical DB.

Output

Each data point is returned as a structured JSON record:

[
  {
    "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"
  },
  {
    "indicator_key": "unemployment",
    "indicator_name": "Unemployment Rate",
    "item_name": "전국",
    "classification": "T10",
    "period": "202412",
    "value": 2.9,
    "unit": "%",
    "org_id": "101",
    "tbl_id": "DT_1DA7002S",
    "source": "KOSIS - Statistics Korea"
  }
]

Data fields

Field	Description
indicator_key	Preset keyword or raw orgId:tblId code
indicator_name	Human-readable indicator name (in selected language)
item_name	KOSIS item sub-classification name
classification	KOSIS classification code (C1)
period	Period string (YYYYMM for monthly or YYYY for annual)
value	Numeric value (null if not released or unavailable)
unit	Unit of measurement (%, index, KRW billions, etc.)
org_id	KOSIS organization ID
tbl_id	KOSIS table ID
source	Always "KOSIS - Statistics Korea"

Cost estimation

Scenario	Data points	Estimated Cost
2 indicators, 12 months	~24	~$0.03
7 preset indicators, 12 months	~84–100	~$0.10
All 7 indicators, 5 years	~420–500	~$0.50
Custom research (20 tables, 10 years)	~2,400	~$2.40

Pricing: $0.001 per run start + $0.001 per data point returned.

FAQ

Do I need to pay for the KOSIS API key? No — the KOSIS OpenAPI key is completely free. Registration is at kosis.kr/openapi, and approval typically takes 1–2 business days. There is no usage quota once approved.

How up-to-date is the data? Data freshness matches the official KOSIS release schedule. Monthly indicators such as CPI and unemployment are typically released 2–4 weeks after the reference month. The actor always queries live from the KOSIS API rather than a cached copy.

Can I fetch data for indicators not in the preset list? Yes — any KOSIS table is accessible by passing the orgId:tblId format in the indicators array. Browse available tables at the KOSIS Statistical DB to find the relevant table codes. Over 200 tables are supported.

---

Disclaimer: This actor retrieves data via the official KOSIS OpenAPI under the terms set by Statistics Korea (공공데이터 이용허락). Users must obtain their own free KOSIS API key and comply with KOSIS API usage terms. This actor is not affiliated with Statistics Korea or the Korean government.

Keywords: KOSIS macro indicators, Korea statistics API, Korean economic data, South Korea macroeconomics, GDP, CPI, unemployment, Statistics Korea, economic indicators, macro data, Korean economy

---

Related actors

• Korea Exchange Pulse — KOSPI, KOSDAQ, and KRW/USD data to pair with KOSIS macro indicators for South Korea analysis
• Kimchi Premium Tracker — Korean crypto premium data to contextualize BTC/crypto demand within Korean macro environment
• BIS Central Bank Rates — Bank of Korea rate data from BIS alongside KOSIS real economy indicators

Feedback

If this actor powers your South Korea economic research, a review helps others find it: Leave a review on Apify Store