페이지 이동경로
  • 문서>
  • 카카오 키워드광고>
  • 사업자 정보

카카오 키워드광고

사업자 정보

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

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

사업자 정보 보기

기본 정보
메서드 URL 인증 방식
GET https://api.keywordad.kakao.com/openapi/v1/companies 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
- 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목		 필요 필요

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

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_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 ${BUSINESS_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스퀘어"
    }
}

더 보기

카카오 키워드광고> 사업자 정보