페이지 이동경로
  • 문서>
  • 카카오 키워드광고

카카오 키워드광고

광고 만들기: 광고계정

이 문서는 광고 만들기: 광고계정 API 사용법을 안내합니다.

광고계정 목록 보기

기본 정보
메서드 URL 인증 방식
GET https://api.keywordad.kakao.com/openapi/v1/adAccounts 액세스 토큰
권한 사전 설정 카카오 로그인 사용자 동의
- 카카오 로그인 활성화
비즈 앱		 필요 -

주의

이 API는 제공 종료될 예정입니다. 신규 API인 광고계정 목록 보기 사용을 권장합니다.

광고계정 목록을 조회합니다. 이 API는 한 번에 최대 1,500개의 광고계정 목록을 조회할 수 있도록 제한되어 있습니다.

액세스 토큰(Access token)을 헤더에 담아 GET으로 요청합니다. 성공 시 응답 본문에 광고계정 목록 배열을 받습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${ACCESS_TOKEN}
인증 방식, 액세스 토큰으로 인증 요청		 O
쿼리 파라미터
이름 타입 설명 필수
config String 광고계정 상태
ON, OFF, DEL 중 하나
미입력 시 ON, OFF만 출력		 X

응답

본문
이름 타입 설명
id Long 광고계정 ID
name String 광고계정명
memberType String 멤버타입
config String 광고계정 상태(ON, OFF, DEL)

예제

요청
curl -v -G GET "https://api.keywordad.kakao.com/openapi/v1/adAccounts" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -d "config=ON,OFF,DEL"
응답
[
    {
      "id": "1111111111",
      "name": "카카오키워드광고_광고계정1",
      "memberType": "MASTER",
      "config":"ON",
    },
    {
      "id": "1111111112",
      "name": "카카오키워드광고_광고계정2",
      "memberType": "MEMBER",
      "config":"ON",
    }
]
카카오 키워드광고