광고계정 관리

이 문서는 광고계정 관리 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스퀘어"
    }
}

더 보기

카카오모먼트 API 레퍼런스