전력데이터 개방 포털시스템

요청 기본정보

요청 기본정보
메서드	요청URL	인코딩	응답포맷
GET, POST	https://bigdata.kepco.co.kr/openapi/v1/powerUsage/contractType.do	UTF-8	JSON, XML

요청 인자

요청 인자
항목명	항목설명	타입	필수여부	세부내용
year	조회연도	STRING	필수	조회연도(YYYY)
month	조회월	STRING	필수	조회월(MM)
metroCd	시도코드	STRING	선택	광역자치단체 코드(ex: 11-서울특별시, 21-부산광역시, 31-경기도) ※ 미선택 시 모든 시도 응답 ※ 공통코드 API로 조회
cityCd	시군구코드	STRING	선택	기초자치단체 코드(ex: 60-청주시, 43-양평군, 26-강남구) ※ 미선택 시 모든 시군구 응답 ※ 공통코드 API로 조회
cntrCd	계약종별	STRING	선택	한국전력 전기계약종별(ex:100-주택용, 200-일반용) ※ 미선택 시 모든 계약종별 응답 ※ 공통코드 API로 조회
apiKey	API 인증키	STRING	필수	발급받은 API 인증키 40자리
returnType	응답포맷	STRING	선택	json : JSON 포맷 응답 xml : XML 포맷 응답 ※ 미선택 시 JSON으로 응답

응답 결과

응답 결과
항목명	항목설명	타입	세부내용
totData	계약종별 전력사용량 합계 내역	LIST	metroCd 미선택 시 모든 지역의 계약종별 전력사용량 내역을 담은 리스트 자료형 ※아래의 응답결과 저장
data	계약종별 전력사용량 내역	LIST	metroCd 선택 시 특정 지역의 계약종별 전력사용량 내역을 담은 리스트 자료형 ※아래의 응답결과 저장
year	조회연도	STRING	조회연도(YYYY)
month	조회월	STRING	조회월(MM)
metro	시도명	STRING	광역자치단체 명(ex:서울특별시, 경기도, 부산광역시 등)
city	시군구명	STRING	기초자치단체 명(ex:청주시, 양평군, 강남구 등)
cntr	계약종별	STRING	한국전력 전기계약종별(ex:주택용, 일반용 등)
custCnt	고객호수	NUMBER	전기사용 고객 호수(호)
powerUsage	전력사용량	NUMBER	전력사용량 합계(kWh)
bill	전기요금	NUMBER	전기요금 합계(원)
unitCost	평균판매단가	NUMBER	전기요금 평균판매 단가(원/kWh)

요청 응답 샘플

요청 응답 샘플
API 요청 예시	https://bigdata.kepco.co.kr/openapi/v1/powerUsage/contractType.do?year=2020&month=11&metroCd=11&cityCd=11&cntrCd=100&apiKey=xxx&returnType=json
API 응답 예시(JSON)	"data" : [ { "year": "2020", "month": "11", "metro": "서울특별시", "city": "종로구", "cntr": "주택용", "custCnt": 65209, "powerUsage": 20468684, "bill": 2366461741, "unitCost": 115.6 } ]

요청 응답 샘플(선택인자 미입력)

요청 응답 샘플
API 요청 예시	https://bigdata.kepco.co.kr/openapi/v1/powerUsage/contractType.do?year=2020&month=11&metroCd=11&cityCd=11&apiKey=xxx&returnType=json
API 응답 예시(JSON)	"data" : [ { "year": "2020", "month": "11", "metro": "서울특별시", "city": "종로구", "cntr": "가로등", "custCnt": 10287, "powerUsage": 793099, "bill": 87834879, "unitCost": 110.7 } ,{ "year": "2020", "month": "11", "metro": "서울특별시", "city": "종로구", "cntr": "교육용", "custCnt": 128, "powerUsage": 7044572, "bill": 719036541, "unitCost": 102.1 } ,{ "year": "2020", "month": "11", "metro": "서울특별시", "city": "종로구", "cntr": "농사용", "custCnt": 11, "powerUsage": 870, "bill": 71023, "unitCost": 81.6 } ...... ]

요청 응답 샘플

API 요청 예시

https://bigdata.kepco.co.kr/openapi/v1/powerUsage/contractType.do?year=2020&month=11&metroCd=11&cityCd=11&apiKey=xxx&returnType=json

API 응답 예시(JSON)

"data" 
: [
     {
       "year": "2020",
       "month": "11",
       "metro": "서울특별시",
       "city": "종로구",
       "cntr": "가로등",
       "custCnt": 10287,
       "powerUsage": 793099,
       "bill": 87834879,
       "unitCost": 110.7
     }
    ,{
       "year": "2020",
       "month": "11",
       "metro": "서울특별시",
       "city": "종로구",
       "cntr": "교육용",
       "custCnt": 128,
       "powerUsage": 7044572,
       "bill": 719036541,
       "unitCost": 102.1
     }
    ,{
       "year": "2020",
       "month": "11",
       "metro": "서울특별시",
       "city": "종로구",
       "cntr": "농사용",
       "custCnt": 11,
       "powerUsage": 870,
       "bill": 71023,
       "unitCost": 81.6
     }           
     
       ...... 
        
  ]

계약종별 전력사용량 API 가이드

요청 기본정보

요청 인자

응답 결과

요청 응답 샘플

요청 응답 샘플(선택인자 미입력)