API 개발자 문서

정치 이슈 트래커 Public API

공약 이행률과 사회 이슈 연결 데이터를 구조화된 JSON으로 제공합니다. 정치부 기자, 연구자, 정당 리서처를 위한 RESTful API.

Getting Started (10분 가이드)

1. 회원가입 · 로그인—회원가입하기 →

2. API Key 발급

curl -X POST "https://www.issuewatch.kr/api/v1/auth/api-key" \
  -H "Content-Type: application/json" \
  -H "Cookie: session_token=..." \
  -d '{"label": "데모 키", "tier": "free"}'

응답의 rawToken은 이번에만 반환됩니다. 반드시 안전한 곳에 저장하세요.

3. 첫 호출

curl -X GET "https://www.issuewatch.kr/api/v1/public/promises?page=1&limit=20" \
  -H "Authorization: Bearer pk_free_YOUR_TOKEN"

플랜별 한도

기자/연구자/정책팀별 활용 예시는 활용 사례 페이지에서 확인할 수 있습니다.

Tier	월 호출	페이지 한도	포함 필드	상태
Free	1,000	20/page	기본 필드 5개	무료
Pro	50,000	100/page	+ description, budget, politician	파일럿 협의
Enterprise	무제한	500/page	+ progress history	파트너 협의

월 호출량 초과 시 다음 달 1일까지 429 Too Many Requests 응답이 반환됩니다.

인터랙티브 API 문서

서비스 개선을 위해 분석 쿠키를 사용합니다. 개인정보처리방침을 확인해 주세요.