공개 API

인증 없이 누구나 자유롭게 이용할 수 있으며(레이트리밋 적용), CORS를 지원합니다. 아래에서 각 엔드포인트를 직접 실행해볼 수 있습니다.

GET /api/search

한국어 형태소 분석(mecab-ko-dic) 기반 전문검색과 5축 패싯 필터링, 3종 정렬을 지원합니다.

쿼리 파라미터

name	type		description
q	string	선택	검색어 (형태소 단위로 매칭)
doc_type	string	선택	문서 유형 필터 (예: notice, policy, law)
ministry	string	선택	부처 코드 필터
year	number	선택	게시연도 필터
law_ref	string	선택	관계 법령 필터
region	string	선택	지역 필터
category	string	선택	카테고리 필터 (예: grant, procurement)
sort	'relevance' \| 'date_desc' \| 'date_asc'	선택	정렬 방식 (기본: 검색어 있으면 정확도순, 없으면 최신순)
page	number	선택	페이지 번호 (기본 1)
size	number	선택	페이지 크기 (기본 20, 최대 50)

예시 응답

{
  "query": "지원",
  "page": 1,
  "size": 2,
  "total": 99,
  "took_ms": 32,
  "results": [
    {
      "id": "432b86c0-0a00-45e8-ae84-93243fc11d3a",
      "doc_type": "notice",
      "title": "2026년 해외진출 지원 참여기업 모집 안내",
      "ministry_code": "mss",
      "ministry_name": "중소벤처기업부",
      "org_type": "부",
      "category": "grant",
      "published_at": "2026-08-12T15:00:00.000Z",
      "source_url": "https://www.k-startup.go.kr/...",
      "source_tier": "api",
      "law_ref": [],
      "region": "세종",
      "kogl_type": 1,
      "attachments": [],
      "score": 0.089,
      "highlight": { "title": "2026년 해외진출 <mark>지원</mark> 참여기업 모집 안내", "body": "..." }
    }
  ],
  "facets": {
    "doc_type": [{ "value": "notice", "label": "notice", "count": 99 }],
    "ministry": [{ "value": "mss", "label": "중소벤처기업부", "count": 99, "org_type": "부" }],
    "published_at": [{ "value": "2026", "label": "2026", "count": 79 }, "..."],
    "law_ref": [],
    "region": [{ "value": "전국", "label": "전국", "count": 7 }, "..."]
  },
  "meta": { "mode": "fulltext", "degraded": false, "kogl_notice": "..." }
}

직접 실행해보기

qdoc_typeministryyearlaw_refregioncategorysortpagesize

GET /api/content/{id}

단일 문서의 정규화된 본문, 관련 문서, KOGL 고지를 반환합니다.

경로 파라미터

name	type		description
id	string (uuid)	필수	문서 ID — 위 /api/search 응답의 id 값을 복사해 사용하세요

예시 응답

{
  "id": "c75a6803-4255-4137-b72e-bad9917c4670",
  "doc_type": "notice",
  "title": "[충북] 2026년 4차 그린뉴딜 유망기업 지원사업 모집공고",
  "body": "본 공고는 ...",
  "ministry_code": "mss",
  "ministry_name": "중소벤처기업부",
  "org_type": "부",
  "category": "grant",
  "published_at": "2026-08-15T15:00:00.000Z",
  "fetched_at": "2026-08-04T10:20:25.168Z",
  "source_url": "https://www.k-startup.go.kr/...",
  "source_tier": "api",
  "alt_sources": [],
  "attachments": [],
  "law_ref": [],
  "region": "충북",
  "kogl_type": 1,
  "lang": "ko",
  "kogl_notice": "공공누리 제1유형: 출처표시",
  "links": {
    "related_by_law": [],
    "same_ministry_recent": [
      { "id": "fc5f7500-...", "doc_type": "notice", "title": "2026년 디지털전환 촉진 지원사업 공고", "published_at": "2026-08-14T15:00:00.000Z" }
    ]
  }
}

직접 실행해보기

GET /api/suggest

제목 부분 일치 기반 자동완성. 각 항목에 문서 유형 태그가 포함됩니다.

쿼리 파라미터

name	type		description
q	string	필수	자동완성 검색어
size	number	선택	결과 수 (기본 8, 최대 10)

예시 응답

{
  "suggestions": [
    { "id": "d4a46701-c8de-4286-ae3f-e220d1afb962", "title": "[전북] 청년창업 지원사업 공고", "doc_type": "notice" },
    { "id": "0f3fd7b9-dbd3-4df7-a556-fc651e4b81af", "title": "[제주] 청년창업 지원사업 공고", "doc_type": "notice" }
  ]
}

직접 실행해보기

qsize

GET /api/ministries

기관 목록과 문서 수를 반환합니다. 전체 합계를 나타내는 _AGGREGATE 항목을 포함합니다.

이 엔드포인트는 파라미터가 필요하지 않습니다.

예시 응답

{
  "ministries": [
    { "ministry_code": "_AGGREGATE", "name": "전체", "org_type": null, "parent_code": null, "doc_count": 99 },
    { "ministry_code": "mss", "name": "중소벤처기업부", "org_type": "부", "parent_code": null, "doc_count": 99 }
  ]
}

직접 실행해보기

GET /api/keywords

자주 등장하는 키워드와 건수, 글자 크기 가중치(1~6)를 반환합니다.

쿼리 파라미터

name	type		description
limit	number	선택	결과 수 (기본 48, 최대 120)

예시 응답

{
  "keywords": [
    { "text": "투자유치", "count": 10, "weight": 6 },
    { "text": "창업교육", "count": 10, "weight": 6 },
    { "text": "해외진출", "count": 9, "weight": 5 }
  ]
}

직접 실행해보기

limit

GET /api/grant/featured

마감일 오름차순으로 정렬된, 현재 접수 중인 지원사업 공고입니다. dday(마감까지 남은 일수)를 포함합니다.

쿼리 파라미터

name	type		description
limit	number	선택	결과 수 (기본 20)

예시 응답

{
  "grants": [
    {
      "id": "cb9fc9a2-aa95-4af6-8574-2620c73c382c",
      "title": "2026년 딥테크 기술사업화 참여기업 모집 안내",
      "org": "중소벤처기업부",
      "ministry_name": "중소벤처기업부",
      "deadline_at": "2026-08-04T15:00:00.000Z",
      "support_field": "창업교육",
      "apply_target": "중소기업",
      "region": "부산",
      "startup_years": "제한없음",
      "source_url": "https://www.k-startup.go.kr/...",
      "kogl_type": 1,
      "dday": 0
    }
  ],
  "total": 62
}

직접 실행해보기

limit