kita.net APIkita.net ↗
Access Korea's import/export data by product (HSK code) and country, trade summaries, KITA notices, and news via 6 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/8c33e423-ae1e-4ce6-b5cc-cfdc6ac93b18/get_total_trade_summary?year=2025' \ -H 'X-API-Key: $PARSE_API_KEY'
Get Korea's total import/export trade summary by year. Returns annual data including export/import amounts (in thousands USD), growth rates, and trade balance. Results are sorted by year descending, paginated at 20 per page.
| Param | Type | Description |
|---|---|---|
| year | string | Year (YYYY format) up to which data is returned. |
| page_num | string | Page number for pagination (20 results per page). |
{
"type": "object",
"fields": {
"items": "array of trade summary objects with period, export_amount, export_growth, import_amount, import_growth, balance",
"total_count": "integer total number of records available"
},
"sample": {
"data": {
"items": [
{
"period": "2025",
"balance": "-1995308",
"export_amount": "49176984",
"export_growth": "-10.1",
"import_amount": "51172292",
"import_growth": "-6.1"
}
],
"total_count": 70
},
"status": "success"
}
}About the kita.net API
The KITA API provides 6 endpoints for accessing Korean trade statistics, policy news, and official announcements from the Korea International Trade Association. Endpoints like get_trade_by_product return HSK-coded product-level export and import figures, while get_trade_by_country breaks down trade volumes by partner country with year-over-year comparisons. Annual summaries, dataset freshness status, KITA notices, and news articles are also available.
Trade Statistics by Product and Country
get_trade_by_product accepts year, month, page_num, and hsk_digit (2, 4, or 6-digit classification) parameters and returns per-product rows containing hsk_code, product_name, cumulative export/import amounts, growth rates, balance, and current-month figures. Results sort by current-month export amount descending, 20 per page. get_trade_by_country takes the same year and month filters and returns per-country rows with country_code, country_name, and side-by-side previous_year and current-year export, import, growth rate, and balance fields — useful for direct year-over-year comparisons without additional transformation.
Annual Trade Summaries and Dataset Status
get_total_trade_summary returns Korea's aggregate annual trade record: period, export_amount, export_growth, import_amount, import_growth, and balance, all denominated in thousands USD. Pass a year parameter to limit results up to a specific year; pagination is available via page_num. To check how current any dataset is before querying, call get_stat_update_status, which returns a list of dataset entries with label (latest data period), latest_data_date, and update_type (frequency notation such as 월간 for monthly).
Notices and News
get_kita_notice_list returns paginated KITA official announcements with category, title, id, and date fields. get_kita_news_list returns trade policy and business news articles in the same shape. Both endpoints accept a page_index parameter for pagination. Neither endpoint currently exposes article body text — only metadata sufficient to identify and date each item.
- Track year-over-year changes in Korea's semiconductor export volumes using
get_trade_by_productfiltered to the relevant HSK code. - Build a dashboard of Korea's top 20 trading partners by current-year export value with
get_trade_by_country. - Monitor annual trade balance trends over multiple decades using
get_total_trade_summarywith year-descending pagination. - Alert on newly published KITA policy announcements by polling
get_kita_notice_listfor newidvalues. - Cross-reference trade news publication dates from
get_kita_news_listwith market data to study announcement effects. - Verify data freshness before running batch queries by first calling
get_stat_update_statusto checklatest_data_dateper dataset. - Analyze Korea's trade deficit or surplus by product category at 2, 4, or 6-digit HSK granularity using the
hsk_digitparameter.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does KITA provide an official developer API?+
What does `get_trade_by_product` return and how granular is the product classification?+
hsk_code and product_name, each containing cumulative and current-month export amount, export growth, import amount, import growth, and trade balance. The hsk_digit parameter controls whether codes are at 2-digit (broad category), 4-digit (subheading), or 6-digit (detailed item) level. Results are sorted by current-month export amount descending and paginated at 20 per page.How does `get_trade_by_country` handle year-over-year comparison?+
previous_year and current-year blocks, each containing export, import, growth rate, and balance fields. This means the comparison is embedded in the response — no need to fetch two separate requests and join them. Filter by year and month to scope the current-year period.Does the API return the full text of KITA news articles or notices?+
get_kita_news_list and get_kita_notice_list return metadata only: category, title, id, and date. Full article body text is not included in the response. You can fork this API on Parse and revise it to add a detail endpoint that fetches article content by ID.