整合台灣最齊全的海關搜索 API

稅則、BSMI、檢疫、法律規範、最大進口國 — 12,676 筆稅則資料整合在一個 API。讓你的系統秒接台灣關務全資料庫，免去自行維護的煩惱。

• 12,676+ 整合稅則筆數
• 14 支援語言
• 18 API 端點
• 99.9% 服務可用率

為什麼選擇我們的搜索 API

• 資料最齊全：整合關務署、BSMI、防檢局、海巡署等多個來源，12,676 筆稅則涵蓋全 21 章節。
• 階層導航：提供類別 → 章 → 節 → 目 → CCC 完整階層 API，方便建構分類選擇器。
• 智慧自動補全：毫秒級自動補全 API，支援中英文模糊搜尋，並可追蹤選擇結果。
• 14 種語言：稅則名稱、章節說明支援 14 種語言，無需自行翻譯。
• 資料新鮮：每旬自動同步政府最新公告，每月覆寫稅則名稱，永遠是最新版。
• 高效能 CDN：Nginx FastCGI + Redis 快取，平均回應時間 <50ms，支援高併發。

API 端點預覽

點擊頁籤查看不同端點的範例回應

• GET https://0523.tw/api/v1/search/tariffs?keyword=iPhone&page=1 — 依關鍵字搜尋稅則，支援中英文、CCC 號碼、別名匹配

  {
    "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
  }

• GET https://0523.tw/api/v1/search/autocomplete?q=iph — 輸入即查詢的自動補全建議，平均回應 30ms

  {
    "success": true,
    "data": [
      { "text": "iPhone 15 Pro", "ccc": "8517.13" },
      { "text": "iPhone 充電器", "ccc": "8504.40" }
    ]
  }

• GET https://0523.tw/api/v1/search/categories — 取得稅則分類階層（類別 / 章節 / 節 / 目）

  {
    "success": true,
    "data": [
      { "section": "01", "name": "活動物；動物產品" },
      { "section": "16", "name": "機器及機械用具" }
    ]
  }

• GET https://0523.tw/api/v1/search/tariff/8517 — 取得單一稅則完整詳情，含 BSMI、檢疫、法規等附加資訊

  {
    "success": true,
    "data": {
      "ccc_code": "8517.13.00.00-7",
      "name_zh": "智慧型手機",
      "tariff_rate": "0%",
      "bsmi_required": true,
      "quarantine": false,
      "regulations": ["NCC 認證"]
    }
  }

• POST https://0523.tw/api/v1/customs/track — 🛃 海關通關狀態即時查詢 — 透過清關單號 (HBL) 查台灣海關通關 5 階段時間軸 (船機抵達 / 連線收單建檔 / 計稅 / 海關放行 / 出倉)。資料源:關港貿單一窗口 GC329 進口簡易貨物動態全流程查詢。支援空快 (mode=空快) 與海快 (mode=海快) 兩種模式。

  // 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"
    }
  }

• GET/POST https://0523.tw/api/v1/freight/quote?weight=8&method=sea — 🚢 海快運費試算 — 輸入重量或材積尺寸 (長×寬×高),即時計算中國 → 台灣海快集運費 (人民幣計價)。計費重取「實重」與「材積重 (÷10000)」較大者;計費重未滿 10 公斤加收附加費（¥20）。專為 0337.tw 等跨境電商平台前台運費報價設計。 查看完整運費 API 開發文檔 →

  {
    "success": true,
    "data": {
      "method": "sea",
      "method_name_zh": "海快",
      "currency": "CNY",
      "billable_weight": 8,
      "rate_per_kg": 10,
      "surcharge": 20,
      "total_fee": 100
    }
  }

• GET/POST https://0523.tw/api/v1/shipment/track?tracking_number=SF1234567890123 — 📦 貨況查詢 — 依單號 (中國快遞單號 / 客戶單號 / 承運單號) 查集運包裹即時狀態與完整時間軸:中國攬收 → 深圳集運倉入倉 → 集運打包/台灣運送 → 台灣海關通關 (GC329 五階段) → 末端配送簽收。回傳僅含物流狀態,不含收件人個資。與好運器官網同源。 查看完整貨況查詢 API 開發文檔 →

  {
    "success": true,
    "tracking_number": "SF1234567890123",
    "data": {
      "status": "已入倉",
      "status_code": 2,
      "is_delivered": false,
      "is_final": false,
      "logistics": "順豐速運",
      "last_event_time": "2026-06-01 12:30:00",
      "timeline": [ ],  // 攬收 → 入倉 → 運送 → 簽收
      "customs_stages": null  // GC329 五階段，未通關為 null
    }
  }

• POST https://0523.tw/api/v1/tax/estimate — 💰 進口稅金試算 — 依商品 (CCC 稅則,或只給商品描述自動 AI 分類) + 外幣金額,即時算出台灣進口稅金:關稅 (含 ECFA / 定額稅)、營業稅、推廣費、貨物稅、菸酒稅,並自動判斷 NT$2,000 小額免稅。以官方每旬海關匯率換算,稅額為新台幣。 查看完整進口稅金試算 API 開發文檔 →

  // Request body:
  {
    "product_description": "棉質女上衣",  // 或給 hs_code
    "currency_code": "CNY",
    "price_foreign": 300
  }
  
  // Response (節錄):
  {
    "success": true,
    "data": {
      "tariff_info": { "duty_rate": 10.5 },
      "tax_breakdown": {
        "duty": 0, "vat": 0, "total_tax": 0,
        "is_tax_exempt": true  // ≤NT$2000 小額免稅
      },
      "total_landed_cost": 1453.6
    }
  }

選擇適合你的方案

依用量計費，量身打造方案 — 所有方案皆可申請試用

• 試用版（30 天免費試用）：新手開發者免費上手 10,000 次請求 / 月； 基礎搜索 API； Email 客服； 30 天試用期；
• 標準版（彈性月費 / 年費）：中小型電商、ERP 系統首選 100,000 次請求 / 月； 全部 API 端點； BSMI / 檢疫 / 法律 加值資料； 優先 Email 客服； API 用量儀表板；
• 企業版（客製化方案）：大型平台、報關行、政府機關 無上限請求量； 專屬 API Key + IP 白名單； SLA 99.95% 保證； WebSocket 即時推送； 專屬技術窗口；

申請開通

填寫資料，我們會在 1 個工作日內聯繫您