오픈API 상세

XML JSON

중앙선거관리위원회_투·개표 정보

투·개표 정보 조회 서비스는 선거의 투표 및 개표 결과 정보를 제공합니다. (선거ID와 선거종류코드, 시도명, 구시군명을 입력하여 투표 결과 및 개표 결과를 조회할 수 있는 서비스) ※ 확인사항 · 투·개표 정보 조회 서비스는 선거 당일 투·개표 진행상황을 실시간으로 제공하는 것은 아니며, 선거 종료 후 선거관리과 협의를 거쳐 통상 2개월 이내에 데이터 이관 및 검증 절차를 완료한 후 제공됩니다. · sgId, sgTypecode, sdName, wiwName은 [코드정보]를 이용해서 조회 가능 · 투표수 : 유효투표수 + 무효투표수 / 선거인수 : 투표수 + 기권수 ◆◇◆ 제공 범위 (2025년 기준) ◆◇◆ · 대 통 령 선 거 : 제14대 ~ 제21대 · 국 회 의 원 선 거 : 제14대 ~ 제22대 · 전국동시지방선거: 제3회 ~ 제8회 · 재 보 궐 선 거 : 2010년 이후 실시 선거
다른 사용자들이 활용한 데이터
중앙선거관리위원회_투·개표 정보로 오픈 API 정보 표로 분류체계, 제공기관 등 정보를 나타냄
분류체계 일반공공행정 - 국정운영 제공기관 중앙선거관리위원회
관리부서명 정보운영과 관리부서 전화번호
API 유형 REST 데이터포맷 JSON+XML
활용신청 666 키워드 투개표,투표결과,개표결과,투표및개표,대통령선거,국회의원선거,전국동시지방선거,재보궐선거
등록일 2018-07-31 수정일 2025-12-03
비용부과유무 무료 신청가능 트래픽 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
심의유형 개발단계 : 자동승인 / 운영단계 : 심의승인
공간범위 대한민국 시간범위 1960년~
이용허락범위
참고문서 OpenAPI활용가이드(투개표정보)_v4.3.zip

상세기능

선거ID, 선거종류. 시도명, 구시군명을 입력받아 투표결과 관련 총선거인수, 선거일투표선거인수, 거소·선상·사전·재외 선거인수,총투표자수, 선거일 투표자수, 거소·선상·사전·재외 투표자수 투표율등을 조회할 수 있는 투표결과 조회

  • 활용승인 절차 개발단계 : 자동승인 / 운영단계 : 심의승인
  • 신청가능 트래픽 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
  • 요청주소 http://apis.data.go.kr/9760000/VoteXmntckInfoInqireService2/getVoteSttusInfoInqire
  • 서비스URL http://apis.data.go.kr/9760000/VoteXmntckInfoInqireService2

요청변수(Request Parameter)

요청변수(Request Parameter)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
서비스키 ServiceKey 4 필수 - 공공데이터포털에서 받은 인증키
페이지 번호 pageNo 4 옵션 1 페이지번호
한 페이지 결과 수 numOfRows 4 옵션 10 한 페이지 결과 수
선거ID sgId 10 필수 20231011 선거ID
선거종류 sgTypecode 2 필수 4 선거종류
시도명 sdName 40 옵션 서울특별시 시도명
구시군명 wiwName 40 옵션 강서구 구시군명

출력결과(Response Element)

출력결과(Response Element)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
결과코드 resultCode 2 필수 00 결과코드
결과메시지 resultMsg 50 필수 OK 결과메시지
한 페이지 결과 수 numOfRows 4 필수 10 한 페이지 결과 수
페이지 번호 pageNo 4 필수 1 페이지번호
전체 결과 수 totalCount 4 필수 3 전체 결과 수
선거ID sgId 10 필수 20231011 선거ID
선거종류코드 sgTypecode 2 필수 4 선거종류코드
시도명 sdName 40 필수 서울특별시 시도명
구시군명 wiwName 40 옵션 강서구 구시군명
총선거인수 totSunsu 10 옵션 1000 총선거인수
선거일투표 선거인수 psSunsu 10 옵션 900 선거일투표 선거인수
거소·사전·선상·재외 선거인수 psEtcSunsu 10 옵션 200 거소·사전·선상·재외 선거인수
총 투표자수 totTusu 10 옵션 800 총 투표자수
선거일 투표자수 psTusu 10 옵션 700 선거일 투표자수
거소·사전·선상·재외 투표자수 psEtcTusu 10 옵션 100 거소·사전·선상·재외 투표자수
투표율 Turnout 10 옵션 80 투표율
정렬순서 vrOrder 3 옵션 1 정렬순서
결과순서 num 8 필수 1 결과순서

샘플코드

샘플코드는 PC에서 확인해주세요.

다른 사용자들이 활용한 데이터
이 데이터와 유사한 데이터