개발자 · API

부스터 공고 데이터 API

v1 · 읽기 전용 REST · 제휴 파트너 전용

부스터(Vster)가 수집·정리한 정부지원사업·행사 공고 데이터를 제휴 파트너가 프로그래밍 방식으로 조회할 수 있는 REST API 입니다. 모든 요청에는 발급받은 API 키가 필요합니다.

로그인하면 이 페이지에서 API 키를 직접 발급받아 바로 사용할 수 있습니다. 로그인 →

1인증필수

모든 요청 헤더에 API 키를 포함하세요. 키는 제휴 계약 후 발급되며, 노출 시 즉시 재발급해야 합니다.

X-API-Key: vster_xxxxxxxxxxxxxxxxxxxx
# 또는
Authorization: Bearer vster_xxxxxxxxxxxxxxxxxxxx

키 발급·한도 상향 문의: 제휴 문의 →

2기본 정보

Base URL	`https://vster.kr/api/v1`
포맷	JSON (UTF-8) · 날짜는 ISO `YYYY-MM-DD`(KST 기준)
요청 한도	키별 기본 분당 60회. 초과 시 `429`.
메서드	GET 만 지원(읽기 전용)

3공고 목록

GET https://vster.kr/api/v1/programs

쿼리 파라미터 (모두 선택)

파라미터	설명
`type`	`support`(지원사업) · `event`(행사·교육). 생략 시 전체.
`status`	`open`(접수중) · `upcoming`(예정) · `closed`(마감)
`region`	지역명(예: `인천광역시`). 광역 또는 시군구 일치.
`cat1` `cat2`	분류 1차/2차(지원분야).
`domain`	산업 도메인 코드(예: `agri`, `mfg`).
`q`	제목 검색어.
`limit`	페이지 크기 1~100(기본 20).
`cursor`	이전 응답의 `nextCursor` 값. 다음 페이지 조회.

예시

curl -H "X-API-Key: $KEY" \
  "https://vster.kr/api/v1/programs?type=support&status=open&region=인천광역시&limit=20"

{
  "data": [
    {
      "id": 60267,
      "type": "support",
      "title": "2027년도 시-군·구 상생일자리 지원사업 공모 공고",
      "category": { "main": "지원사업", "sub": "인력·고용", "field": "인력·고용·일자리" },
      "domains": ["labor"],
      "region": "인천광역시",
      "localGov": "인천광역시",
      "agency": { "governing": "인천광역시", "executing": "인천광역시청(경제정책과)" },
      "applyPeriod": {
        "text": "2026. 11. 5.(목) ~ 11. 19.(목)",
        "start": "2026-11-05", "end": "2026-11-19",
        "type": "dated", "status": "open"
      },
      "postedAt": "2026-11-04",
      "applyUrl": null,
      "event": null,
      "links": { "web": "https://vster.kr/programs/60267" },
      "updatedAt": "2026-11-05T05:04:51.196Z"
    }
  ],
  "nextCursor": 60248
}

nextCursor가 null이면 마지막 페이지입니다. 다음 페이지는 ?cursor=60248로 이어 호출하세요.

4공고 단건

GET https://vster.kr/api/v1/programs/{id}

목록 항목의 id로 단건을 조회합니다. 응답은 { "data": { …목록과 동일한 객체… } } 형태입니다.

curl -H "X-API-Key: $KEY" "https://vster.kr/api/v1/programs/60267"

5응답 필드

필드	설명
`id`	공고 고유 ID(영구). 상세 페이지 `links.web`의 키.
`type`	`support` \| `event`
`category`	`{ main, sub, field }` 분류.
`agency`	`{ governing, executing }` 소관·수행기관.
`applyPeriod`	`{ text, start, end, type, status }`. `text`=원문 표기, `status`=실시간 접수상태.
`event`	행사형(type=event)일 때 `{ venue, fee, capacity }`, 아니면 `null`.
`applyUrl`	외부 신청 URL(있을 때).
`links.web`	부스터 공고 상세 페이지(공고문 전문·첨부는 여기서 확인).

접수상태 status 값: open(접수중) · upcoming(예정) · closed(마감) · unknown(미정).

6에러

상태	code	의미
401	`missing_api_key`	키 헤더 없음
401	`invalid_api_key`	유효하지 않거나 폐기된 키
429	`rate_limited`	분당 한도 초과
404	`not_found`	해당 공고 없음
500	`internal_error`	일시적 서버 오류

에러 응답 형식:

{ "error": { "code": "invalid_api_key", "message": "유효하지 않은 API 키입니다." } }

7MCP (AI 어시스턴트 연결)

동일한 데이터를 MCP(Model Context Protocol)로도 제공합니다. Claude 등 MCP 지원 AI 어시스턴트가 자연어로 공고를 직접 검색·조회할 수 있습니다. 원격 MCP(Streamable HTTP) 엔드포인트:

https://vster.kr/api/mcp
인증: Authorization: Bearer <API 키>   (REST 와 동일한 키)

제공 도구

도구	설명
`search_programs`	조건(type·region·status·cat·domain·q·limit·cursor)으로 공고 검색
`get_program`	공고 ID로 단건 상세 조회

연결 설정 예시 (MCP 클라이언트)

{
  "mcpServers": {
    "vster": {
      "url": "https://vster.kr/api/mcp",
      "headers": { "Authorization": "Bearer vster_xxxxxxxx" }
    }
  }
}

커스텀 헤더(Bearer) 지정이 가능한 MCP 클라이언트에서 동작합니다. 완전 원클릭(OAuth) 연결은 추후 지원 예정입니다.

8이용 조건중요

API 키는 제휴 계약 범위 내에서만 사용하며, 제3자에게 양도·공유할 수 없습니다.
제공 데이터는 참고용이며 정확성·최신성을 보증하지 않습니다. 최종 자격·마감은 원문 공고(links.web)로 확인해야 합니다.

이용약관 →|개인정보처리방침 →