HSコード分類API
商品名を自然言語で入力するとHSコード(品目分類番号)候補と国別の関税率をJSONで返すAPIです。当サイトの検索画面と 同じロジックをそのまま公開しているため、画面で見つかる品目はAPIでも 同じように見つかります。
エンドポイント
GET /api/v1/classify — RapidAPIマーケットプレイスで サブスクライブしてから呼び出します。
| パラメータ | 必須 | 説明 |
|---|---|---|
q | 要 | 自然言語の商品名(最大200文字)。HSコード(4〜10桁の数字)を直接入力しても構いません。 |
lang | 任意 | ko / ja / en(デフォルト ko) |
countries | 任意 | カンマ区切りの国コード。デフォルトはkr。FTA相手国コード(us, eu, cn, jpなど)にも対応します。 |
limit | 任意 | 返す候補数 1〜5(デフォルト 5) |
リクエスト例
curl "https://korea-hs-code-classification-api.p.rapidapi.com/api/v1/classify?q=ワイヤレスイヤホン&lang=ja&countries=kr" \
-H "X-RapidAPI-Key: <サブスクライブ後に発行されるキー>" \
-H "X-RapidAPI-Host: korea-hs-code-classification-api.p.rapidapi.com"X-RapidAPI-KeyはRapidAPIでサブスクライブすると自動的に発行されます。 パラメータとレスポンス形式は上記と同じです。
料金プラン
| プラン | 価格 | 月間呼び出し上限 |
|---|---|---|
| Free | $0 | 50 calls / month |
| PRO | $9.99 | 1,000 calls / month |
| ULTRA | $49.99 | 10,000 calls / month |
精度と制約
正解セット28件による実測: top1精度 64% ・ top5再現率 93%。レスポンスのscoreは検索順位スコアであり、分類精度の確率ではありません。
このAPIが返す税番・税率は韓国関税庁の公開データを加工した参考情報であり法的効力はありません。 実際の通関に使用する前には、必ず 通関業者または韓国関税庁にご確認ください。
お問い合わせ
APIに関するお問い合わせ・不具合のご報告は help@pix-make.com までご連絡ください。