2026년 11월 17일 화요일

업체 한 건을 더 깊게 이해하는 38개 필드, 스타트디비 JSON 데이터는 무엇을 담을까요?

스타트디비는 전국 사업자 검색과 상세정보를 엑셀·REST API·MCP로 연결하는 DB 서비스입니다. 공식 응답 예시는 최상위 38개 필드로 업체 기본정보, 대표자·주소 이력, 출처별 후보값과 연락처 확인 정보를 담는 구조를 보여줍니다.

스타트디비 공식 화면(2026-11-15 확인)
스타트디비 공식 화면(2026-11-15 확인)

스타트디비는 무엇을 하는 서비스인가요?

스타트디비는 업무에 필요한 전국 사업자 자료를 찾아보는 검색 서비스입니다. 관심 지역과 업종, 업체명을 기준으로 대상을 찾고 검색 목록과 상세정보를 살펴본 뒤 엑셀 자료로 연결할 수 있습니다. 신규 사업자와 매장, 법인과 온라인 판매자처럼 서로 다른 조사 대상을 한곳에서 탐색할 수 있다는 점이 핵심입니다. 처음 사용하는 사람은 어떤 자료를 어디서부터 찾아야 할지 정하는 단계에서, 반복 조사하는 팀은 같은 조건으로 자료를 살펴보는 단계에서 활용할 수 있습니다.

서비스를 가장 쉽게 이해하는 흐름은 검색 조건 선택, 업체 목록 확인, 필요한 상세정보 검토, 엑셀로 다음 업무 준비의 네 단계입니다. 스타트디비는 조회할 자료의 출발점을 제공하고 사용자는 자신의 목적에 맞게 검토와 활용을 이어갑니다. 고객 후보를 조사하는 영업팀, 관련 업체를 찾아보는 구매팀, 지역별 사업자 자료를 준비하는 마케팅팀이라면 어떤 검색을 시작할지 바로 떠올릴 수 있습니다.

업체 이름 한 칸에서 구조화된 자료로

스타트디비 공식 홈은 업체 한 건의 API·MCP 응답을 JSON 형식으로 소개합니다. 최상위 필드는 38개이며 업체 식별과 이름, 업종과 지역, 연락처 외에도 대표자·주소 이력, 출처별 후보값, 연락처 확인 결과, 조달 입찰 관련 항목을 담는 구조입니다. 화면의 응답은 가상 업체를 사용한 예시이고 실제 값은 해당 업체의 확보 자료와 이용 범위를 기준으로 확인합니다. 개발팀은 이 구조를 보며 어떤 정보를 내부 화면에 표시하고 어떤 자료를 후속 검토에 사용할지 구체적으로 설계할 수 있습니다. 스타트디비의 강점은 검색으로 찾은 업체를 사람이 읽는 목록과 시스템이 다루는 데이터로 함께 연결한다는 점입니다.

공식38개 최상위필드의 역할
공식38개 최상위필드의 역할

기본정보를 내부 업무의 기준에 연결

공식 예시의 id와 docId는 업체 자료를 구분하는 항목으로, name과 bizNo는 업체명과 사업자번호를 읽을 위치로 살펴볼 수 있습니다. industry와 region, address는 업종과 지역·주소의 맥락을 이해하는 데 활용합니다. tel·mobile·email·fax·homepage는 확보된 연락처와 웹 정보를 확인할 항목입니다. 내부 시스템을 설계할 때는 각 필드가 어떤 업무 질문에 답하는지 매핑표를 만들 수 있습니다. 실제로 제공된 값과 화면에 표시할 내용을 검토하고 원문과 내부 해석을 구분합니다. 같은 업체의 자료를 여러 업무 화면에서 사용할 때도 공통 식별 기준을 남겨두면 후속 검토의 맥락을 이해하기 좋습니다.

여러 값과 이력을 함께 읽는 구조

공식 응답 예시에는 ceos와 addresses, options 같은 항목이 보입니다. 대표자와 주소의 이력, 출처별 후보값을 담는 구조를 통해 현재 읽고 있는 값과 관련 자료의 관계를 살펴볼 수 있습니다. 예시의 options에는 field, value, sourceLabel, collectedAt, rank, primary처럼 값의 종류와 출처·수집 시점·선택 관련 정보를 설명하는 항목이 나타납니다. 개발팀은 자료를 단일 값으로만 표시할지, 검토 담당자가 출처와 후보를 함께 읽게 할지 목적에 맞춰 설계할 수 있습니다. 실제 응답에서 어떤 값이 있는지 확인하며 화면을 구성합니다. 스타트디비의 상세 구조를 업무상 판단 근거를 보관하는 방식과 연결하는 활용입니다.

연락처 확인 정보도 항목별로 살펴보기

contactList와 emailStatus, emailCheckedAt, homepageStatus, homepageCheckedAt 등은 연락처와 웹 정보의 확인 상태를 읽을 수 있는 구조로 소개됩니다. 공식 가상 예시의 contactList에는 종류와 번호 끝자리, 확인 여부와 확인 시점 등의 항목이 보입니다. 팀은 실제 응답에서 어떤 값이 제공되었는지 확인하고 그 항목이 의미하는 범위를 업무 화면에 분명하게 표시할 수 있습니다. 서로 다른 확인 항목을 하나의 포괄적인 보증으로 합치기보다 제공된 상태와 시점을 그대로 읽는 방식입니다. 데이터 구조를 이해하면 사용자가 어떤 자료를 확인했는지 설명하는 화면도 구체적으로 준비할 수 있습니다.

공식 예시의 출처·시점 구조
공식 예시의 출처·시점 구조

엑셀16열과 JSON38필드는 목적에 맞게

엑셀은 팀이 표로 검토하고 공유할 때, JSON은 내부 시스템의 화면과 작업 흐름에 연결할 때 활용할 수 있습니다. 스타트디비 공식 홈은 두 형식의 구성을 함께 보여줍니다. 개발팀은 먼저 실제 업무에서 필요한 정보를 정하고 엑셀의 열과 API 응답 필드가 어떤 목적을 맡을지 비교해볼 수 있습니다. 예를 들어 담당자가 자료를 검토하는 표에는 핵심 항목을 두고, 상세 확인 화면에는 출처와 후보값의 맥락을 연결하는 설계입니다. 이는 활용 기획의 예시이며 실제 연동은 개발자 문서와 응답을 확인하며 진행합니다. 같은 데이터가 사람의 검토와 시스템의 처리에 각각 어떻게 쓰일지 생각할 수 있습니다.

첫 연동 설계는 필드 매핑표에서

내부 업체 식별자, 필요한 스타트디비 필드, 실제 응답 예시, 사용자에게 표시할 이름, 확인 시점을 한 표로 적어보세요. 공식 홈의 38필드 구조와 개발자 문서를 읽으며 실제로 필요한 항목을 선택할 수 있습니다. 개인정보나 인증정보는 공개 원고가 아닌 팀의 승인된 관리 환경에서 다루며 실제 업무 목적에 맞는 접근 범위를 정합니다. 공식 예시의 필드와 실제로 확인한 응답을 나누어 읽으면 필요한 정보가 어떤 값으로 제공되는지 팀의 기준에 맞춰 검토하기 좋습니다. 스타트디비의 구조화된 자료를 활용하면 업체 탐색에서 상세 맥락 확인, 내부 업무 연결까지 어떤 정보를 이어갈지 구체적으로 설계할 수 있습니다.

목적에 맞는 데이터 활용
목적에 맞는 데이터 활용

한 종류를 집중해서 볼 때는 라인, 폭넓게 쓸 때는 전체

공식 표시 요금은 라인 이용권 월 24,000원과 전체 이용권 월 39,000원입니다. 라인은 선택한 DB 1종을 집중해서 활용하는 구성이고, 전체는 14종 DB를 함께 살펴보는 구성입니다. 조사 대상이 한 종류에 모여 있다면 라인을, 여러 자료를 함께 비교하고 활용한다면 전체를 기준으로 이용 범위를 정해볼 수 있습니다.

전체 이용권은 1개월 39,000원, 3개월 99,000원, 6개월 174,000원, 12개월 288,000원으로 안내돼 있습니다. 12개월은 결제 총액 288,000원, 월 환산 24,000원입니다. 현재 표시된 월간 요금 39,000원을 12번 계산한 468,000원과 비교하면 12개월 구성의 총액은 180,000원 낮습니다. 이는 같은 서비스의 공개 기간별 요금을 비교한 산식입니다. 반복 조사가 예정된 팀은 실제 이용 기간과 함께 비용을 계획하기 좋습니다.

조회와 부가서비스의 비용 구조를 이해하면 계획이 쉬워집니다

이용권 범위 안의 목록·상세·엑셀 조회에는 추가 크레딧이 들지 않습니다. 전체 이용권의 엑셀 제공량은 회당 10,000건, 하루 50,000건, 30일 300,000건으로 안내됩니다. 라인은 회당 10,000건, 하루 20,000건, 30일 60,000건입니다. 팀은 조사할 자료의 범위와 작업 주기를 기준으로 이용권과 엑셀 작업을 계획할 수 있습니다.

가입 시 300크레딧과 이용권 결제액의 5% 크레딧 적립도 안내돼 있습니다. 이용권은 검색·조회 범위를 선택하는 구성이고, 등기부등본과 회선 확인 같은 부가서비스는 별도 건별 크레딧으로 이용합니다. 어떤 업무가 기본 조회인지 어떤 업무가 부가서비스인지 구분해두면 필요한 예산을 설명하기 좋습니다. 공식 요금 화면에서 이용권의 기간과 제공 범위를 함께 살펴보세요.

데이터 구조를 운영 화면으로 연결
데이터 구조를 운영 화면으로 연결
스타트디비 공식 화면(2026-11-15 확인)
스타트디비 공식 화면(2026-11-15 확인)

첫 작업을 시작해 보세요

스타트디비의 공식 화면에서 이 글에서 확인한 항목을 직접 비교해 보세요.

스타트디비에서 자료 범위 확인하기

#스타트디비 #사업자DB #데이터활용 #업무자료 #기업정보

댓글 없음:

댓글 쓰기