Taiwan's Most Complete Customs Search API

Tariffs, BSMI, quarantine, regulations, top importers — 12,676 tariff entries integrated into one API. Plug your system into Taiwan's full customs database in minutes, no maintenance needed.

12,676+ Tariff Entries
14 Languages
31 API Endpoints
99.9% Uptime SLA

Why Our Search API

Most Complete Data：Integrates Customs Bureau, BSMI, BAPHIQ, Coast Guard and more — 12,676 entries across all 21 sections.
Hierarchical Navigation：Section → Chapter → Heading → Subheading → CCC full hierarchy API, perfect for category pickers.
Smart Autocomplete：Millisecond autocomplete with fuzzy matching in Chinese & English, with selection tracking.
14 Languages：Tariff names and chapter descriptions in 14 languages, no translation work needed.
Always Fresh：Auto-synced with government bulletins every 10 days, monthly tariff name overwrites.
Fast CDN：Nginx FastCGI + Redis cache, average response <50ms, supports high concurrency.

API Endpoint Preview

Click tabs to see sample responses from different endpoints

GET https://0523.tw/api/v1/search/tariffs?keyword=iPhone&page=1 — Search tariffs by keyword — supports Chinese, English, CCC codes and alias matching

{
  "success": true,
  "data": [
    {
      "id": 8517,
      "ccc_code": "8517.13.00.00-7",
      "name_zh": "smartphone",
      "name_en": "Smartphones",
      "tariff_rate": "0%",
      "vat": "5%",
      "top_importer": "China"
    }
  ],
  "total": 42
}

GET https://0523.tw/api/v1/search/autocomplete?q=iph — Type-ahead autocomplete suggestions, ~30ms average response

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

GET https://0523.tw/api/v1/search/categories — Get tariff classification hierarchy (Section / Chapter / Heading / Subheading)

{
  "success": true,
  "data": [
    { "section": "01", "name": "Live animals; animal products" },
    { "section": "16", "name": "Machinery and Mechanical Appliances" }
  ]
}

GET https://0523.tw/api/v1/search/tariff/8517 — Single tariff full detail with BSMI, quarantine, regulations etc.

{
  "success": true,
  "data": {
    "ccc_code": "8517.13.00.00-7",
    "name_zh": "smartphone",
    "tariff_rate": "0%",
    "bsmi_required": true,
    "quarantine": false,
    "regulations": ["NCC certification"]
  }
}

POST https://0523.tw/api/v1/customs/track — 🛃 Real-time customs clearance status — look up Taiwan's 5-stage clearance timeline by clearance number (HBL) (vessel/flight arrival / data filing / tax assessment / customs release / warehouse-out). Source: Customs-Port-Trade Single Window GC329 import cargo tracking. Supports two modes: air express (mode=air express) and sea express (mode=sea express).

// Request body:
{
  "hbl": "691MK539819",
  "mode": "Sea express"   // air express / Sea express (Optional)
}

// Response:
{
  "success": true,
  "cached": false,
  "data": {
    "hbl": "691MK539819",
    "mawb": "TEPTTP260450073",
    "declaration_no": "AX/15/620/E2ZV0",
    "mode": "Sea express",
    "current_stage_name": "Out of position",
    "progress_percent": 100,
    "is_completed": true,
    "stages": [
      { "code": "XX", "name": "Ship (aircraft) arrives", "time": "2026-04-29 07:18:00", "done": true },
      { "code": "E1", "name": "Online order acquisition and file creation", "time": "2026-04-29 02:29:40", "done": true },
      { "code": "D1", "name": "tax calculation", "time": "2026-04-29 02:29:40", "done": true },
      { "code": "RL", "name": "Customs release", "time": "2026-04-29 02:29:41", "done": true },
      { "code": "OW", "name": "Out of position", "time": "2026-04-29 15:17:43", "done": true }
    ],
    "source": "Customs and port trade single window GC329"
  }
}

GET/POST https://0523.tw/api/v1/freight/quote?weight=8&method=sea — 🚢 Sea Express freight quote — enter weight or dimensions (L×W×H) to instantly calculate China → Taiwan sea-express consolidation freight (priced in CNY). Billable weight = max(actual weight, volumetric weight ÷10000); a surcharge applies when billable weight is under 10 kg. Built for cross-border e-commerce platforms such as 0337.tw to quote freight at checkout. View full Freight API docs →
```
{
  "success": true,
  "data": {
    "method": "sea",
    "method_name_zh": "Sea express",
    "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 — 📦 Shipment tracking — look up a parcel's real-time status and full timeline by tracking number (China courier / customer order / carrier number): China pickup → Shenzhen warehouse-in → consolidation/Taiwan transit → Taiwan customs clearance (GC329 5 stages) → last-mile delivery. Returns logistics status only, no recipient personal data. Same data source as the 0523.tw website. View full Shipment Tracking API docs →
```
{
  "success": true,
  "tracking_number": "SF1234567890123",
  "data": {
    "status": "Already placed in warehouse",
    "status_code": 2,
    "is_delivered": false,
    "is_final": false,
    "logistics": "SF Express Express",
    "last_event_time": "2026-06-01 12:30:00",
    "timeline": [ ],  // Collect → Enter a warehouse → transport → Sign for receipt
    "customs_stages": null  // GC329 five stages, null if not cleared
  }
}
```
POST https://0523.tw/api/v1/tax/estimate — 💰 Import tax estimate — given a product (CCC tariff code, or just a description for automatic AI classification) + foreign-currency value, instantly compute Taiwan import taxes: customs duty (incl. ECFA / specific duty), VAT, trade-promotion fee, commodity tax and tobacco/alcohol tax, with automatic NT$2,000 de-minimis exemption. Converted via the official customs FX rate; amounts in TWD. View full Import Tax API docs →
```
// Request body:
{
  "product_description": "Cotton women's tops",  // or give hs_code
  "currency_code": "CNY",
  "price_foreign": 300
}

// Response (excerpt):
{
  "success": true,
  "data": {
    "tariff_info": { "duty_rate": 10.5 },
    "tax_breakdown": {
      "duty": 0, "vat": 0, "total_tax": 0,
      "is_tax_exempt": true  // ≤NT$2000 Small amount tax-free
    },
    "total_landed_cost": 1453.6
  }
}
```

GET/POST/PUT https://0523.tw/api/v1/merchant/skus/batch — 🛒 Merchant API (for Shopee / Coupang / momo sellers) — bulk-create SKUs and product barcodes, forecast purchase tracking numbers, get a labeling work order automatically when parcels arrive at the Shenzhen warehouse, and receive stock and receiving results by webhook. Available to registered companies only. View the full Merchant API documentation →

// POST /api/v1/merchant/skus/batch
{
  "items": [
    { "seller_sku": "TEE-RED-S", "barcode": "4710000000011", "product_name": "Cotton T-shirt",
      "spec": { "color": "red", "size": "S" }, "hs_code": "61091000006", "declared_unit_value": 18.5, "declared_currency": "CNY" }
  ]
}

// 200
{
  "success": true,
  "data": [ { "index": 0, "seller_sku": "TEE-RED-S", "status": "created",
              "sku": { "pick_code": "131999", "regulation": { "status": "ok" } } } ],
  "meta": { "summary": { "created": 1, "updated": 0, "failed": 0 } }
}

// POST /api/v1/merchant/inbound-orders → 201   GET /api/v1/merchant/inventory?warehouse_code=SZ

Choose Your Plan

Usage-based pricing, custom plans available — all plans include a free trial

Trial（30-day free trial）：Free for solo developers to get started 10,000 requests / month； Basic search API； Email support； 30-day trial period；
Standard（Flexible monthly / annual）：Best for SMB e-commerce & ERP systems 100,000 requests / month； All API endpoints； BSMI / quarantine / legal value-add data； Priority email support； API usage dashboard；
Enterprise（Custom plan）：Large platforms, customs brokers, government Unlimited requests； Dedicated API key + IP whitelist； 99.95% SLA guarantee； WebSocket real-time push； Dedicated technical contact；

Apply for Access

Fill in your details and we'll contact you within 1 business day