kakao developers

광고계정 관리

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

사업자 정보 보기

기본 정보

GET /openapi/v4/companies HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}

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

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

요청

헤더

이름	타입	설명	필수
Authorization	String	액세스 토큰 Bearer ${ACCESS_TOKEN} 형식으로 전달	O
adAccountId	Long	광고계정 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: ${adAccountId}"

응답

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

더 보기

카카오모먼트 API 레퍼런스