페이지 이동경로
  • 문서>
  • 카카오모먼트>
  • 광고계정 관리

카카오모먼트

광고계정 관리

이 문서는 광고계정 관리 API 사용 방법을 안내합니다.

사업자 정보 보기

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

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

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

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O
쿼리 파라미터
이름 타입 설명 필수
bizNum String 사업자등록번호 O

응답

본문
이름 타입 설명
id Long 사업자 번호
businessRegistrationNumber String 사업자등록번호
name String 사업자
representationName String 대표자
address Address 주소
businessCategory String 업태
businessItem String 종목
Address
이름 타입 설명
baseAddress String 기본주소
detailAddress String 상세주소
zipCode String 우편번호

예제

요청
curl -X GET "https://apis.moment.kakao.com/openapi/v4/companies?bizNum=120-81-47521" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}"
응답
{
    "id": 680,
    "businessRegistrationNumber": "123-12-12345",
    "name": "주식회사 사업자",
    "representationName": "사업자대표",
    "businessCategory": "서비스",
    "businessItem": "서비스",
    "address": {
        "zipCode": "13494",
        "baseAddress": "경기 성남시 분당구 판교역로 235",
        "detailAddress": "H스퀘어"
    }
}

더 보기

카카오모먼트> 광고계정 관리