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

카카오모먼트

광고계정 관리

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

더 보기

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