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=나이키%20운동화&lang=ko&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

RapidAPI에서 구독하기 ↗

정확도와 한계

정답 세트 28건 기준 실측: top1 정확도 64% · top5 재현율 93%. 응답의 score는 검색 순위 점수이며 분류 정확도 확률이 아닙니다.

이 API가 반환하는 세번·세율은 관세청 공개데이터를 가공한 참고 정보이며 법적 효력이 없습니다. 실제 통관에 쓰기 전에는 관세사 또는 관세청에 반드시 확인하십시오.

문의

API 관련 문의·오류 제보는 help@pix-make.com로 연락해 주십시오.