프리미엄
비즈니스

직시 데이터 API

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

인증
무인증공개 엔드포인트 /api/public/* 는 키 없이 바로 읽을 수 있어요(읽기 전용).
키 인증/api/data/* 는 헤더 Authorization: Bearer <key> 또는 x-api-key: <key> 로 인증해요.
※ 현재는 공개 베타예요. 서버에 API 키가 설정되지 않은 상태에서는 키 없이도 공개데이터를 제공합니다. 키 발급(전용 키·대량/상용 이용)은 자동 발급이 아니라 비즈니스 문의 로 안내해 드려요.
엔드포인트 키 인증 · /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
응답 형태
/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/* 호출이 통과할 수 있어요. 전용 키가 필요하면 비즈니스로 문의해 주세요.
키 발급 · 상용 이용 문의
전용 API 키, 대량·상용 이용, 화이트라벨 연동이 필요하신가요? 비즈니스 페이지에서 도입 문의를 남겨 주시면 빠르게 안내해 드릴게요.
비즈니스 문의하기

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

직시·WATCHDOG