Skip to main content
GET
사업자 프로필 검색

인증

Authorization
string
header
필수

API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요.

쿼리 매개변수

keyword
string
필수

검색어. 상호, 이전 상호, 영문 상호, 대표자명, 상호 초성 3자 이상, 사업자등록번호 10자리로 찾습니다. 앞뒤 공백을 뺀 100자 이하, 공백과 기호를 뺀 2글자 이상으로 입력하세요. 사업자등록번호로 찾으면 그 사업자 한 건을 돌려줍니다.

limit
integer
기본값:20

한 번에 받을 결과 수. 한 번에 차감하는 포인트는 최대 limit × 9포인트입니다.

필수 범위: 1 <= x <= 50
cursor
string

이전 응답의 nextCursor. 받은 값을 그대로 보내세요. cursor는 받을 때의 keyword, excludeStatuses, 키 모드(테스트, 라이브)에 묶입니다. 조건이나 키 모드를 바꿨다면 cursor 없이 처음부터 다시 검색하세요.

excludeStatuses
enum<string>[]

결과에서 뺄 사업자 등록 상태. 쉼표로 구분하세요. 휴업이나 폐업으로 확인된 사업자를 빼고, 볼타가 상태를 확인하지 않은 사업자는 남깁니다.

Minimum array length: 1
사용 가능한 옵션:
SUSPENDED,
CLOSED

응답

검색 성공. 결과가 없으면 items가 빈 배열이고 포인트를 차감하지 않습니다.

사업자 프로필 검색 결과

items
object[]
필수

검색 결과. 관련도가 높은 순입니다.

nextCursor
string | null
필수

다음 결과를 받을 cursor. 마지막이면 null입니다.

hasMore
boolean
필수

다음 결과가 있으면 true입니다.