依關鍵字搜尋稅則，支援中英文、CCC 號碼、別名匹配
GEThttps://0523.tw/api/v1/search/tariffs?keyword=iPhone&page=1
{
"success": true,
"data": [
{
"id": 8517,
"ccc_code": "8517.13.00.00-7",
"name_zh": "智慧型手機",
"name_en": "Smartphones",
"tariff_rate": "0%",
"vat": "5%",
"top_importer": "中國"
}
],
"total": 42
}
輸入即查詢的自動補全建議，平均回應 30ms
GEThttps://0523.tw/api/v1/search/autocomplete?q=iph
{
"success": true,
"data": [
{ "text": "iPhone 15 Pro", "ccc": "8517.13" },
{ "text": "iPhone 充電器", "ccc": "8504.40" }
]
}
取得稅則分類階層（類別 / 章節 / 節 / 目）
GEThttps://0523.tw/api/v1/search/categories
{
"success": true,
"data": [
{ "section": "01", "name": "活動物；動物產品" },
{ "section": "16", "name": "機器及機械用具" }
]
}
取得單一稅則完整詳情，含 BSMI、檢疫、法規等附加資訊
GEThttps://0523.tw/api/v1/search/tariff/8517
{
"success": true,
"data": {
"ccc_code": "8517.13.00.00-7",
"name_zh": "智慧型手機",
"tariff_rate": "0%",
"bsmi_required": true,
"quarantine": false,
"regulations": ["NCC 認證"]
}
}
🛃 海關通關狀態即時查詢 — 透過清關單號 (HBL) 查台灣海關通關 5 階段時間軸 (船機抵達 / 連線收單建檔 / 計稅 / 海關放行 / 出倉)。資料源:關港貿單一窗口 GC329 進口簡易貨物動態全流程查詢。支援空快 (mode=空快) 與海快 (mode=海快) 兩種模式。
POSThttps://0523.tw/api/v1/customs/track
// Request body:
{
"hbl": "691MK539819",
"mode": "海快" // 空快 / 海快 (選填)
}
// Response:
{
"success": true,
"cached": false,
"data": {
"hbl": "691MK539819",
"mawb": "TEPTTP260450073",
"declaration_no": "AX/15/620/E2ZV0",
"mode": "海快",
"current_stage_name": "出倉",
"progress_percent": 100,
"is_completed": true,
"stages": [
{ "code": "XX", "name": "船(機)抵達", "time": "2026-04-29 07:18:00", "done": true },
{ "code": "E1", "name": "連線收單建檔", "time": "2026-04-29 02:29:40", "done": true },
{ "code": "D1", "name": "計稅", "time": "2026-04-29 02:29:40", "done": true },
{ "code": "RL", "name": "海關放行", "time": "2026-04-29 02:29:41", "done": true },
{ "code": "OW", "name": "出倉", "time": "2026-04-29 15:17:43", "done": true }
],
"source": "關港貿單一窗口 GC329"
}
}
