광고계정 관리

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

사업자 정보 보기

기본 정보

메서드	URL	인증 방식
GET	https://apis.moment.kakao.com/openapi/v4/companies	액세스 토큰

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

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

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

요청

헤더

이름	설명	필수
Authorization	Authorization: Bearer ${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 ${ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}"

응답

{
    "id": 680,
    "businessRegistrationNumber": "123-12-12345",
    "name": "주식회사 사업자",
    "representationName": "사업자대표",
    "businessCategory": "서비스",
    "businessItem": "서비스",
    "address": {
        "zipCode": "13494",
        "baseAddress": "경기 성남시 분당구 판교역로 235",
        "detailAddress": "H스퀘어"
    }
}

더 보기

카카오모먼트 API 레퍼런스