페이지 이동경로
  • 문서>
  • 카카오 키워드광고>
  • 사업자 정보

카카오 키워드광고

사업자 정보

이 문서는 사업자 정보 API 사용 방법을 안내합니다.

사업자 정보는 광고를 진행하기 위한 사업자 광고계정 생성 시 확인할 수 있습니다.

사업자 정보 보기

기본 정보

GET /openapi/v1/companies HTTP/1.1
Host: api.keywordad.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}

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

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

Request

Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer ${ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
bizNum String 사업자등록번호 O

Response

Name Type Description
id Long 사업자 ID
businessRegistrationNumber String 사업자등록번호
name String 사업자 이름
representationName String 대표자 이름
businessCategory String 업태
businessItem String 종목
address Address 주소

Sample

Request
curl -X GET "https://api.keywordad.kakao.com/openapi/v1/companies?bizNum=120-81-47521" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "AdAccountId: {adAccountId}"
Response
HTTP/1.1 200 OK
Content-type: application/json;charset=UTF-8
{
    "id": "000",
    "businessRegistrationNumber": "120-81-47521",
    "name": "주식회사 사업자",
    "representationName": "사업자대표",
    "businessCategory": "서비스",
    "businessItem": "서비스",
    "address": {
        "zipCode": "13494",
        "baseAddress": "경기 성남시 분당구 판교역로 235",
        "detailAddress": "H스퀘어"
    }
}

더보기

카카오 키워드광고> 사업자 정보