국민연금공단_수급현황

(국민연금공단 수급현황) 법정동단위 지역별, 연령대별, 성별, 연금종별(노령, 장애, 유족) 수급자 통계 정보* 상세기능(오퍼레이션 목록)1. 수급현황 정보조회2. 최고값 정보조회3. 연령별 정보조회* 항목설명○ 성별구분코드: M(남자), F(여자)○ 급여종별코드: 10(노령) 20(장애) 30(유족) 00(전체)○ 평균연금수급액(월): 해당 조건의 수급자의 월 평균 연금 수급금액○ 평균누적연금수급액: 해당 조건의 수급자의 월 평균 연금 실수령액(소급,환수 포함)○ 평균납부액대비수급액기준: 해당 조건의 수급자의 납부금액(보험료) 대비 수급금액 비율

body header item items 결과메세지 결과코드 전체 결과 수 총인원수 최고납부액대비수급액기준 최고누적연금수급액 최고연금수급액 페이지 번호 평균납부액대비수급액기준 평균누적연금수급액 평균수급기간 평균수급기간(월) 평균연금수급액(월) 평균연급수급액(월) 한 페이지 결과 수

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '10:노령=값' \
  --data-urlencode '20:장애=값' \
  --data-urlencode '30:유족=값' \
  --data-urlencode '00:전체=값' \
  --data-urlencode 'M:남자=값' \
  --data-urlencode 'F:여자=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "10:노령": "값",
  "20:장애": "값",
  "30:유족": "값",
  "00:전체": "값",
  "M:남자": "값",
  "F:여자": "값",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "10:노령": "값",
    "20:장애": "값",
    "30:유족": "값",
    "00:전체": "값",
    "M:남자": "값",
    "F:여자": "값",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())