사업자 정보

이 문서는 사업자 정보 API 사용 방법을 안내합니다.

사업자 정보는 광고를 진행하기 위한 사업자 광고계정 생성 시 확인할 수 있습니다.

사업자 정보 보기

기본 정보

메서드	URL	인증 방식
GET	https://api.keywordad.kakao.com/openapi/v1/companies	액세스 토큰

권한	사전 설정	카카오 로그인	사용자 동의
-	카카오 로그인 활성화 비즈 앱	필요	-

사업자 정보를 조회합니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청합니다. 조회할 사업자의 사업자등록번호를 파라미터로 전달해야 합니다. 성공 시 응답 본문에 JSON 객체로 사업자의 상세 정보를 받습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

요청

헤더

이름	설명	필수
Authorization	Authorization: Bearer ${ACCESS_TOKEN} 인증 방식, 액세스 토큰으로 인증 요청	O
adAccountId	adAccountId: ${AD_ACCOUNT_ID} 광고계정 ID	O

쿼리 파라미터

이름	타입	설명	필수
bizNum	String	사업자등록번호	O

응답

본문

이름	타입	설명
id	Long	사업자 ID
businessRegistrationNumber	String	사업자등록번호
name	String	사업자 이름
representationName	String	대표자 이름
businessCategory	String	업태
businessItem	String	종목
address	Address	주소

예제

요청

curl -v -G GET "https://api.keywordad.kakao.com/openapi/v1/companies" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -d "bizNum=120-81-47521"

응답

HTTP/1.1 200 OK
Content-type: application/json;charset=UTF-8
{
    "id": "000",
    "businessRegistrationNumber": "120-81-47521",
    "name": "주식회사 사업자",
    "representationName": "사업자대표",
    "businessCategory": "서비스",
    "businessItem": "서비스",
    "address": {
        "zipCode": "13494",
        "baseAddress": "경기 성남시 분당구 판교역로 235",
        "detailAddress": "H스퀘어"
    }
}

더 보기

카카오 키워드광고 API 레퍼런스