KITA 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.
What is the KITA 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.
curl -X GET 'https://api.parse.bot/scraper/8c33e423-ae1e-4ce6-b5cc-cfdc6ac93b18/get_total_trade_summary?year=2025&page_num=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace kita-net-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: KITA Trade Statistics — bounded, re-runnable; every call capped."""
from parse_apis.kita_trade_statistics_api import Kita, HskDigit, Month, TradeDataNotFound
client = Kita()
# List Korea's annual trade summaries (most recent years first).
for summary in client.tradesummaries.list(year="2025", limit=3):
print(summary.period, summary.export_amount, summary.balance)
# Drill into product-level trade using HSK 2-digit classification.
product = client.producttrades.list(year="2025", month=Month._01, hsk_digit=HskDigit.TWO, limit=1).first()
if product:
print(product.hsk_code, product.product_name, product.cumulative.export)
# Top trading partner countries for a given month.
for country in client.countrytrades.list(year="2025", month=Month._05, limit=3):
print(country.country_name, country.current_year.export, country.current_year.export_growth)
# Typed error handling: catch when trade data is unavailable.
try:
for item in client.tradesummaries.list(year="1900", limit=1):
print(item.period)
except TradeDataNotFound as exc:
print(f"No data: {exc}")
# Latest KITA news articles.
news = client.newsarticles.list(limit=1).first()
if news:
print(news.title, news.date)
# Dataset update status — check freshness of statistics.
for status in client.datasetstatuses.list(limit=3):
print(status.label, status.latest_data_date, status.update_type)
print("exercised: tradesummaries.list / producttrades.list / countrytrades.list / newsarticles.list / datasetstatuses.list")
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 | integer | 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 API
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.
The KITA API is a managed, monitored endpoint for kita.net — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when kita.net changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official kita.net API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.