공개 검색 · Content API

GET/api/search

한국어 형태소 풀텍스트 + 시맨틱 벡터 하이브리드 검색과 5축 패싯 (부처·문서유형·기간·법령·지역) 집계를 반환합니다.

curl "https://korea-onegov.vercel.app/api/search?q=청년+주거&doc_type=policy&size=5"

{
  "query": "청년 주거",
  "page": 1,
  "size": 5,
  "total": 128,
  "took_ms": 42,
  "results": [
    {
      "id": "3f2a…-uuid",
      "doc_type": "policy",
      "title": "청년 주거 지원 …",
      "summary": "…",
      "ministry_code": "molit",
      "ministry_name": "국토교통부",
      "category": null,
      "published_at": "2026-03-04T00:00:00+09:00",
      "source_url": "https://…",
      "kogl_type": 1,
      "attachments": [ … ],
      "highlight": { "title": "<em>청년</em> <em>주거</em> …" }
    }
  ],
  "facets": {
    "doc_type": [ { "value": "policy", "label": "정책", "count": 61 } ],
    "ministry": [ … ], "published_at": [ … ], "law_ref": [ … ], "region": [ … ]
  },
  "meta": { "mode": "hybrid", "degraded": false, "kogl_notice": "…" }
}

GET/api/content/{id}

단일 문서의 정규화 본문(body) 전문과 연관 문서(links: 관련 법령·같은 기관 최신), 출처·공공누리 고지(kogl_notice)를 반환합니다. 없거나 폐기된 문서는 404.

curl "https://korea-onegov.vercel.app/api/content/3f2a…-uuid"

{
  "id": "3f2a…-uuid",
  "doc_type": "policy",
  "title": "…",
  "body": "정규화된 본문 전문 …",
  "ministry_name": "국토교통부",
  "published_at": "2026-03-04T00:00:00+09:00",
  "source_url": "https://…",
  "kogl_type": 1,
  "kogl_notice": "공공누리 제1유형. 원문: 국토교통부",
  "links": {
    "related_by_law": [ … ],
    "same_ministry_recent": [ … ]
  }
}

GET/api/suggest

저지연 자동완성(제목 prefix·부분일치, 벡터 미사용).

curl "https://korea-onegov.vercel.app/api/suggest?q=전세"

{ "suggestions": [ { "text": "전세사기 특별법 …", "doc_type": "law" } ] }

GET/api/ministries

색인 대상 기관 목록(패싯 라벨 소스). 기관별 문서 수 포함.

curl "https://korea-onegov.vercel.app/api/ministries"

{ "ministries": [
  { "ministry_code": "molit", "name": "국토교통부", "org_type": "부", "doc_count": 1820 }
] }

GET/api/keywords

제목 토큰 빈도 상위 주제어(검색어 클라우드 소스).

curl "https://korea-onegov.vercel.app/api/keywords?limit=30"

{ "keywords": [ { "text": "소상공인", "count": 412, "weight": 6 } ] }

GET/api/grant/featured

마감 임박 지원사업 공고(category=grant)를 마감임박순(deadline_at ASC, 미래 마감)으로 반환합니다. 전체 목록은 /search?category=grant.

curl "https://korea-onegov.vercel.app/api/grant/featured?limit=6"

{
  "grants": [
    {
      "id": "…-uuid",
      "title": "2026년 …바우처 지원사업",
      "org": "(사)한국중소기업발전협회",
      "deadline_at": "2026-07-17T00:00:00+09:00",
      "dday": 1,
      "support_field": "사업화",
      "apply_target": "연구기관,일반기업,1인 창조기업",
      "region": "전국",
      "source_url": "https://www.k-startup.go.kr/…"
    }
  ],
  "total": 249
}