개발자 API

인증과 한도

인증 헤더

X-API-Key: bzn_… (또는 쿼리 ?apiKey=)

호출 주소

https://api.biznum.kr

한도 응답 헤더

X-RateLimit-Limit, X-RateLimit-Remaining

오류

401 키 없음·무효 · 403 정지된 키 · 429 일일 한도 초과

엔드포인트

GET /api/public/biz/{번호}

상세 + 국세청 상태 + 기업 개요(법인). ?live=true 로 즉시 재조회

GET /api/public/biz/search

q(2자 이상), type=auto|name|ceo|phone|bizno, sido, status, corpYn, page, size(최대 50)

GET /api/public/biz/list

검색어 없이 지역·상태 필터 목록 (신고일 최신순)

GET /api/public/biz/suggest

상호 자동완성 q

POST /api/public/biz/validate

진위확인 { bizNo, startDt(yyyyMMdd), ceoName, companyName? }

POST /api/public/biz/status

일괄 상태 { bizNos: [...] } 최대 100건 (1건으로 계산)

GET /api/public/apikeys/me

내 키 상태·오늘 사용량

예시

curl -H "X-API-Key: bzn_여러분의키" \
  "https://api.biznum.kr/api/public/biz/1208800767"

curl -H "X-API-Key: bzn_여러분의키" \
  "https://api.biznum.kr/api/public/biz/search?q=쿠팡&size=5"

curl -X POST -H "X-API-Key: bzn_여러분의키" -H "Content-Type: application/json" \
  -d '{"bizNos":["1208800767","2208162517"]}' \
  https://api.biznum.kr/api/public/biz/status

응답은 { success, message, data, totalCount } 형식입니다. 상태 값은 국세청 기준(계속사업자·휴업자·폐업자)이며, 공정위 업소상태는 statusFtc로 함께 제공됩니다. 데이터의 출처와 한계는 데이터 출처·기준일을 참고하세요.