직시 데이터 API

제22대 국회 입법 투명성 데이터(국회의원·법안·청원)를 읽기전용 JSON으로 제공해요. 모든 값은 공개데이터(열린국회정보 · 국민동의청원) 기반이며, 사실에는 출처를 함께 표기합니다.

인증
무인증공개 엔드포인트 /api/public/* 는 키 없이 바로 읽을 수 있어요(읽기 전용).
키 인증/api/data/* 는 헤더 Authorization: Bearer <key> 또는 x-api-key: <key> 로 인증해요.
※ /api/data/* 는 발급받은 키가 있어야 호출할 수 있어요. 키가 없거나 맞지 않으면 401, 서버에 키가 준비되지 않은 상태면 503(api_not_configured)로 응답합니다. 키 발급은 자동 발급이 아니라 비즈니스 문의 로 안내해 드려요.
오픈 데이터(CSV) 무료 · 키 없이 다운로드
표결·의원 활동의 집계 스냅샷을 CSV로 열어 뒀어요. 회원가입·키 없이 바로 받아서 기사·논문·리포트에 쓰실 수 있습니다. 사실 수치만 담기며, 등급 같은 평가 값은 넣지 않아요.
본회의 표결 집계 CSV 받기
jiksi_votes_2026-09-30.csv · 열: billId, billNo, 의안명, 처리결과, 처리일, 찬성, 반대, 기권, 원문링크
의원 활동(사실 수치) CSV 받기
jiksi_member_activity_2026-09-30.csv · 열: 의원명, 정당, 지역구, 대표발의수, 표결참여수, 표결기록수, 표결참여율(0~1)
기준일스냅샷 기준일 2026-09-30. 파일명에 기준일이 들어가 있어 어느 시점 데이터인지 그대로 인용할 수 있어요.
갱신 주기법안·표결 스냅샷은 하루 1회 자동 갱신해요. 의원 활동 수치는 발의·표결 전수를 다시 계산하는 작업이라 별도 재계산 시점에 갱신됩니다(기준 범위는 방법론).
인용 표기출처: 직시(jiksi-next.vercel.app) · 원출처: 열린국회정보 로 표기해 주세요. 개별 안건은 CSV의 원문링크(의안정보시스템)를 함께 걸어 주시면 독자가 원본을 확인할 수 있어요.
CSV는 UTF-8 BOM 포함(엑셀에서 한글이 깨지지 않아요) · 첫 행은 헤더이며 주석 행은 없어요 · 값에 쉼표·따옴표가 있으면 RFC 4180 방식으로 이스케이프합니다. ?format=csv 없이 호출하면 같은 데이터를 JSON으로 받을 수 있어요.
무료 CSV는 집계 스냅샷까지예요. 원본·실시간 데이터(단건 상세, 필터·페이지네이션 JSON)는 /api/data/* 키 인증 영역이라 비즈니스 문의로 안내해 드립니다.
내 관심 분야만 골라 담고 싶다면 인텔 워치리스트 에서 분야별 법안·청원을 CSV·JSON으로 내보낼 수 있어요(개인용 소량 내보내기). 여기 오픈 데이터 CSV는 전체 스냅샷 배포용이라 목적이 달라요.
엔드포인트 키 인증 · /api/data/*
GET/api/data키 인증
API 인덱스(엔드포인트·인증·출처·라이선스 자기문서).
GET/api/data/members키 인증
국회의원 목록. 사실 필드 + 등급은 gradeOpinion(의견) 키로 분리.
쿼리 파라미터
party정당 정식명칭으로 필터
region시·도(예: 서울, 경기, 비례)로 필터
q이름 부분검색
limit기본 50, 1~200
offset기본 0
GET/api/data/members/{monaCd}키 인증
의원 단건 상세(활동 포함). 없으면 404. monaCd는 열린국회정보 공개키.
GET/api/data/bills키 인증
법안 목록(처리결과·소관위·대표발의자·표결집계).
쿼리 파라미터
q의안명·대표발의자 부분검색
stage진행단계(1=발의·접수, 2=위원회 심사, 3=본회의 표결)
limit기본 50, 1~200
offset기본 0
GET/api/data/bills/{billId}키 인증
법안 단건 상세(관련 청원 부분일치 포함). 없으면 404.
GET/api/data/petitions키 인증
국민동의청원 목록(제목·취지·동의수·상태·소관위).
쿼리 파라미터
q제목·취지 부분검색
category분야로 필터
status상태(예: 동의 진행 중 / 위원회 회부)로 필터
limit기본 50, 1~200
offset기본 0
엔드포인트 무인증 공개 · /api/public/*
GET/api/public/bills무인증
제22대 법안(의안정보·표결집계). 무인증 공개 읽기.
쿼리 파라미터
limit기본 50, 1~200
GET/api/public/petitions무인증
국민동의청원 공개 현황. 무인증 공개 읽기.
쿼리 파라미터
limit기본 50, 1~200
GET/api/public/rulings무인증
법제처 판례. 연동 키(OC) 미발급 시 빈 배열로 반환(가짜 미제공).
쿼리 파라미터
limit기본 50, 1~200
GET/api/public/votes무인증
본회의 표결 집계 스냅샷(찬성·반대·기권). format=csv 로 전체 행 CSV 다운로드.
쿼리 파라미터
limitJSON 응답 개수. 기본 50, 1~200
formatcsv 이면 CSV 전체 행 다운로드(limit 무시)
GET/api/public/member-activity무인증
의원 활동 사실 수치(대표발의·표결참여). 등급 등 평가 값은 포함하지 않아요.
쿼리 파라미터
limitJSON 응답 개수. 기본 50, 1~200
formatcsv 이면 CSV 전체 행 다운로드(limit 무시)
응답 형태
/api/data/* 응답은 공통 봉투 { data, meta, source, disclaimer } 형태예요.
{
  "data": [
    {
      "monaCd": "...",
      "name": "...",
      "party": "...",
      "district": "...",
      "facts": { "proposeCount": 0, "voteParticipation": 0 },
      "gradeOpinion": "...",
      "gradeBasisOpinion": "..."
    }
  ],
  "meta": { "total": 0, "limit": 50, "offset": 0, "count": 0 },
  "source": "열린국회정보 · 국민동의청원 (공개데이터)",
  "disclaimer": "..."
}
사실(facts)과 의견(opinion)은 분리돼 있어요. 표결·발의·청원·소관위 등은 '사실'이고, 등급처럼 플랫폼 평가에 해당하는 값은 *Opinion 접미 키(예 gradeOpinion, gradeBasisOpinion)로만 노출됩니다. 정치성향·개인 민감정보(PIPA)는 제공하지 않아요.
/api/public/* 응답은 데이터셋 메타와 항목 배열을 함께 담아요.
{
  "dataset": "bills",
  "count": 50,
  "source": "열린국회정보 · 의안정보시스템",
  "snapshot": "YYYY-MM-DD",
  "license": "공개 데이터 재사용 가능. 출처 표기 권장.",
  "items": [ /* ... */ ]
}
페이지네이션
  • limit — 한 번에 가져올 개수. 기본 50, 최대 200.
  • offset — 건너뛸 개수. 기본 0 (/api/data/* 목록에서 지원).
  • /api/data/* 의 meta 에 총건수(total)·limit·offset·count가 함께 와요.
라이선스 · 출처
원천 데이터는 대한민국 국회 공개데이터(열린국회정보 · 국민동의청원)에 기반해요. 재사용 시 원 출처를 표기하고 각 기관의 이용약관을 따라 주세요.
표시되는 값 중 표결·발의·청원·소관위 등은 '사실'(출처 표기)이고, *Opinion 키는 플랫폼 평가 '의견'이에요. 수치는 적재 시점 스냅샷이므로 원문 출처가 항상 우선합니다.
요청 예시
키 인증(/api/data)
curl -H "Authorization: Bearer <key>" \
  "https://jiksi-next.vercel.app/api/data/members?limit=50"
x-api-key 헤더로도 가능해요
curl -H "x-api-key: <key>" \
  "https://jiksi-next.vercel.app/api/data/bills?stage=3&limit=20"
무인증 공개(/api/public)
curl "https://jiksi-next.vercel.app/api/public/petitions?limit=10"
※ <key> 자리에는 발급받은 키를 넣어 주세요. 키 없이 /api/data/* 를 호출하면 401로 거절됩니다. /api/public/* 만 키 없이 열려 있어요.
키 발급 · 상용 이용 문의
API 이용 안내
현재 상태/api/data/* 는 키 발급제로 운영해요. 발급된 키가 있어야 호출할 수 있습니다.
대상언론사 데이터팀, 연구자·학계, 공공·기관 등 입법 데이터를 자체 분석·서비스에 쓰시는 곳을 염두에 두고 있어요.
플랜유료 플랜은 공개 정가 없이 문의 기반이에요. 사용량·용도·연동 범위를 듣고 조건을 함께 정합니다.
문의 시 사용 목적, 예상 호출량, 필요한 데이터셋(의원·법안·청원)을 알려 주시면 검토가 빨라져요. 공개 데이터 기반이라 /api/public/* 는 계속 무인증으로 열려 있습니다.
전용 API 키, 대량·상용 이용, 화이트라벨 연동이 필요하신가요? 비즈니스 페이지에서 도입 문의를 남겨 주시면 빠르게 안내해 드릴게요.
비즈니스 문의하기

직시 데이터 API는 공개된 입법·규제 정보를 출처와 함께 구조화해 제공하는 읽기 전용 도구예요. 모든 사실 데이터는 공개 출처(열린국회정보 · 국민동의청원)에 기반하며, 평가에 해당하는 값은 의견(*Opinion) 키로 분리됩니다.

직시·WATCHDOG