사이드 메뉴
시작하기
로그인
커뮤니케이션
광고
카카오 키워드광고
사업자 정보
이 문서는 사업자 정보 API 사용 방법을 안내합니다.
사업자 정보는 광고를 집행하기 위한 사업자 광고계정 생성 시 확인할 수 있습니다.
| 메서드 | URL | 인증 방식 |
|---|---|---|
GET | https://api.keywordad.kakao.com/openapi/v1/companies | 비즈니스 토큰 |
사업자 정보를 조회합니다.
비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청합니다. 조회할 사업자의 사업자등록번호를 파라미터로 전달해야 합니다. 성공 시 응답 본문에 JSON 객체로 사업자의 상세 정보를 받습니다. 실패 시 에러 코드로 원인을 확인합니다.
| 이름 | 설명 | 필수 |
|---|---|---|
| Authorization | Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}인증 방식, 비즈니스 토큰으로 인증 요청 | O |
| adAccountId | adAccountId: ${AD_ACCOUNT_ID}광고계정 ID | O |
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| bizNum | String | 사업자등록번호 | O |
| 이름 | 타입 | 설명 |
|---|---|---|
| id | Long | 사업자 ID |
| businessRegistrationNumber | String | 사업자등록번호 |
| name | String | 사업자 이름 |
| representationName | String | 대표자 이름 |
| businessCategory | String | 업태 |
| businessItem | String | 종목 |
| address | Address | 주소 |
요청
curl -v -G GET "https://api.keywordad.kakao.com/openapi/v1/companies" \-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \-H "adAccountId: ${AD_ACCOUNT_ID}" \-d "bizNum=120-81-47521"
응답
HTTP/1.1 200 OKContent-Type: application/json;charset=UTF-8{"id": "000","businessRegistrationNumber": "120-81-47521","name": "주식회사 사업자","representationName": "사업자대표","businessCategory": "서비스","businessItem": "서비스","address": {"zipCode": "13494","baseAddress": "경기 성남시 분당구 판교역로 235","detailAddress": "H스퀘어"}}