API REFERENCE

한국 전체 수출입 시계열

한국 공식 수출·수입·무역수지의 월별 시계열을 가져올 수 있어요. 데이터 출처는 관세청 OpenAPI Newtrade — 산업통상자원부가 매월 발표하는 값과 100% 일치해요. 1990-01 부터 데이터가 있어요.

요청

http

GET /api/public/v2/exports/total?from=2021-06&to=2026-05 HTTP/1.1
Host: www.bulliza.com
Authorization: Bearer rfk_live_<your-key>

쿼리 파라미터

이름	타입	필수	설명
`from`	YYYY-MM	선택	시작월. 미지정 시 1990-01 부터 전체
`to`	YYYY-MM	선택	종료월. 미지정 시 최신 확정월

응답

필드	타입	설명
`from`	string	실제 응답 시작월
`to`	string	실제 응답 종료월
`currency`	string	항상 <InlineCode>USD</InlineCode>
`monthly`	object[]	월별 데이터 배열 — period 오름차순
`monthly[].period`	string	YYYY-MM
`monthly[].export_value`	number	수출액 (USD)
`monthly[].import_value`	number	수입액 (USD)
`monthly[].trade_balance`	number	무역수지 (USD) — 양수면 흑자

json

{
  "from": "2024-01",
  "to": "2026-05",
  "currency": "USD",
  "monthly": [
    { "period": "2024-01", "export_value": 54600000000, "import_value": 54400000000, "trade_balance": 200000000 },
    { "period": "2024-02", "export_value": 52400000000, "import_value": 48000000000, "trade_balance": 4400000000 }
  ],
  "disclaimer": "관세청 OpenAPI Newtrade 기반 한국 공식 수출입 총합 시계열입니다."
}

호출 예시

bash

# 최근 5년
curl -H "Authorization: Bearer rfk_live_<your-key>" \
  "https://bulliza.com/api/public/v2/exports/total?from=2021-06"

# 2024년만
curl -H "Authorization: Bearer rfk_live_<your-key>" \
  "https://bulliza.com/api/public/v2/exports/total?from=2024-01&to=2024-12"

python

import os, requests, pandas as pd

r = requests.get(
    "https://bulliza.com/api/public/v2/exports/total",
    params={"from": "2020-01"},
    headers={"Authorization": f"Bearer {os.environ['RICHGO_API_KEY']}"},
).json()

df = pd.DataFrame(r["monthly"])
df["yoy_export"] = df["export_value"].pct_change(12) * 100
print(df.tail())

현재 진행 중인 월은 제외돼요

Newtrade API 는 확정 전 partial 값을 같이 반환하는데, 시계열의 신뢰성을 위해 응답에서는확정된 월까지만 포함시켜요. 잠정치(현재 월) 데이터는 별도 endpoint 로 추가될 예정이에요.

다음 단계