지원사업 공고 - 공공데이터 기업 위험 조회

1. 지원사업 공고 조회opendata.smes.notices

MCP 도구 이름 opendata__smes__notices

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

신청기간이 끝나지 않은(접수 예정 포함) 중소기업 지원사업 공고를 분야(금융, 기술, 인력, 수출, 내수, 창업, 경영, 기타)와 지역이나 업종 같은 해시태그로 골라 조회합니다.

Request

변수명	필수	설명
Authorization	Y	API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. 형식 : Basic base64("{client_id}:{client_secret}") [참고] 인증
X-Env-Scope	Y	호출 환경입니다. `real_test`데모 — 현재 데모 한도 확인 필요 `production`정식 — 현재 공개 요금제 전용 [참고] 환경
Idempotency-Key	Y	재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. [참고] 재시도
Content-Type	Y	요청 본문 형식입니다. `application/json`고정값 (기본값)
X-Trace-Id	N	추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.

변수명	타입	필수	설명
provider	string	Y	호출할 기관입니다. `opendata`이 API 고정값 (기본값) 예시 : opendata
action	string	Y	호출할 작업입니다. `opendata.smes.notices`이 API 고정값 (기본값) 예시 : opendata.smes.notices
params	object	Y	작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fields	object	N	민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. [참고] 암호화

변수명	타입	필수	설명
field	string	N	지원 분야(선택). 가운데 하나(코드 도 됩니다). 비우면 전 분야
hashtags	array	N	해시태그(선택). 지역이나 업종 같은 낱말 목록이며 하나라도 맞는 공고를 고릅니다(예: 서울, 제조업). 낱말 안에 공백은 넣지 않습니다
noticeId	string	N	공고 ID(선택). 한 공고만 다시 조회할 때 notices 의 pblancId 값을 줍니다
pageNo	number	N	페이지 번호(선택, 기본 1)
numOfRows	number	N	한 페이지 공고 수(선택, 기본 50)
output_formats	array	N	이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다

bash

curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header 'Idempotency-Key: demo-notices-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "opendata",
  "action": "opendata.smes.notices",
  "params": {}
}'

Response

아래 표의 칸은 작업이 SUCCEEDED 가 된 뒤 GET /v1/jobs/{job_id}/result 의 result.data 에 오고, 응답 예시는 작업을 제출했을 때(POST /v1/jobs)의 응답입니다.
이 API 가 돌려주는 데이터: 공고명, 소관기관명, 수행기관명, 지원분야, 신청기간, 지원대상, 해시태그, 사업개요내용, 사업신청방법내용, 문의처, 공고 원문 링크, 사업신청 링크, 등록일시

변수명	타입	설명
source_id	string	이 작업의 원천 데이터셋 번호입니다. 이 작업에서는 항상 15157820 입니다(공공데이터포털 data.go.kr 의 번호).
action	string	호출한 작업 이름입니다. 이 작업에서는 항상 opendata.smes.notices 입니다.
job_id	string	이 결과를 만든 작업의 ID 입니다.
source	object	원천의 출처 정보입니다. 결과를 사용자에게 보여 줄 때 출처 표시에 씁니다.
source.id	string	원천 데이터셋 번호입니다. source_id 와 같은 값입니다.
source.org	string	원천 데이터를 제공하는 기관 이름입니다. 이 작업에서는 항상 중소벤처기업부 입니다.
source.license	string	원천 데이터의 이용 허락 범위 표기입니다. 값은 원천마다 다르고, 결과를 보여 줄 때 출처 표시와 함께 씁니다.
license_notes	array	출처 표시 문구, 이용 허락 표기, 결과 해석 안내가 이 순서로 담긴 문장 목록입니다. 첫 줄은 「출처: 중소벤처기업부 중소기업 지원사업 공고(기업마당) / data.go.kr 15157820」 입니다.
upstream	object	중소기업 지원사업 공고 목록 한 쪽을 분야와 해시태그로 골라 조회한 결과입니다. 공고의 각 칸은 원문 그대로이며 요약하거나 고쳐 쓰지 않습니다. 아래 칸은 우리가 정해 담습니다.
upstream.source_op	string	원천에서 부른 조회 이름입니다. 이 작업에서는 항상 pblancBsnsService 입니다.
upstream.filters	object	이번 조회에 실제로 쓴 조건입니다.
upstream.filters.field	string \| null	조회에 쓴 분야의 이름입니다. 금융, 기술, 인력, 수출, 내수, 창업, 경영, 기타 가운데 하나이고 분야를 고르지 않았으면 null 입니다.
upstream.filters.field_code	string \| null	조회에 쓴 분야의 코드입니다. 분야를 고르지 않았으면 null 입니다.
upstream.filters.hashtags	array	조회에 쓴 해시태그 목록입니다. 해시태그를 보내지 않았으면 빈 목록이고, 목록 안의 해시태그는 하나라도 맞으면 찾는 조건으로 쓰입니다.
upstream.filters.notice_id	string \| null	조회에 쓴 공고 ID 입니다. 공고 하나만 찾도록 보냈을 때만 값이 있고 아니면 null 입니다.
upstream.notices	array	공고 목록입니다. 한 공고가 한 행이며 공고명, 공고 ID, 소관기관, 수행기관, 지원분야, 신청기간, 지원대상, 사업개요, 신청 방법, 문의처, 원문 링크, 등록과 수정 일시 등 스무 칸이 원문 그대로 담깁니다. 원문에 없는 칸은 null 입니다. 신청기간이 끝나지 않은 공고만 실리며, 비어 있으면 조회 시점에 그 조건의 공고를 찾지 못했다는 뜻이고 지원사업이 없다는 확인서는 아닙니다.
upstream.total_count	number \| null	조건에 맞는 공고의 전체 건수입니다. 이번 쪽에 담긴 건수가 아니며 원천이 알려 주지 않으면 null 입니다.
upstream.page_no	number	이번에 조회한 쪽 번호입니다.
upstream.num_of_rows	number	한 쪽에 요청한 공고 수입니다.
upstream.truncated	boolean	전체 건수가 지금까지 돌려준 건수보다 많아 뒤 쪽이 남았는지를 나타냅니다. true 이면 pageNo 를 올려 다음 쪽을 조회합니다. 전체 건수를 알 수 없으면 false 입니다.
upstream.coverage_note	string	이 조회의 범위와 한계를 알리는 안내문입니다. 신청기간이 끝나지 않은 공고만 실린다는 점, 공고 내용은 원문 그대로이며 자세한 내용과 신청은 원문 링크에서 확인해야 한다는 점, 비어 있는 결과가 지원사업이 없다는 확인서가 아니라는 점, 전체 건수가 돌려준 건수보다 많으면 pageNo 로 다음 쪽을 조회할 수 있다는 점을 적습니다.

json

{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "opendata",
    "action": "opendata.smes.notices",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

순번	오류 코드	발생 조건
	POLICY_QUOTA_EXCEEDED	공공데이터 조회의 하루 한도를 모두 쓰면 작업이 이 오류로 끝납니다. error.message 는 「오늘 이 조직의 공공데이터 조회 한도를 모두 썼습니다. 한국시간 자정에 다시 열립니다. 한도 상향이 필요하면 서비스문의로 알려 주세요.」 꼴이고, 한도의 범위에 따라 「이 조직의」 대신 「무료 요금제 몫의」 나 「서비스 전체」 가 들어갑니다. 자정이 지난 뒤에 다시 요청합니다.
	PROVIDER_UPSTREAM_ERROR	공공데이터 제공처가 오류로 답하면 작업이 이 오류로 끝나고, error.message 는 응답 상태로 고릅니다. 429 이면 「요청이 잠시 제한되었습니다. 잠시 후 다시 시도해 주세요.」, 403 이면 「요청하신 자료를 조회할 권한이 없습니다. 연동한 계정에 그 권한이 있는지 확인해 주세요.」, 500번대이면 「일시적인 오류로 요청을 마치지 못했습니다. 잠시 후 다시 시도해 주세요.」, 그 밖의 400번대이면 「요청을 처리할 수 없습니다. 입력한 값을 다시 확인해 주세요.」 입니다. 응답은 받았는데 읽지 못했거나 상태를 알 수 없으면 「기관에서 받은 응답을 처리하지 못했습니다. 잠시 후 다시 시도해 주시고, 계속되면 서비스문의로 알려 주세요.」 가 오고, 상태가 400번대도 500번대도 아니면 「서버 내부 오류로 작업을 마치지 못했습니다. 잠시 후 다시 시도해 주세요.」 가 옵니다.
	VALIDATION_INVALID_FIELD	요청 값이 맞지 않으면 작업이 이 오류로 끝나고, 요청을 고쳐 다시 보냅니다. 값이 빠지면 error.message 는 「요청에 필요한 값이 빠졌습니다. 빠진 값: 칸 이름. 그 값을 넣어 다시 요청해 주세요.」 꼴이고, 값의 형식이 틀리면 「요청 값이 올바르지 않습니다. 확인할 값: 칸 이름. 값을 고쳐 다시 요청해 주세요.」 꼴입니다(칸 이름이 다섯을 넘으면 앞 다섯과 「외 N개」 를 적습니다). 사업자등록번호 칸이면 「사업자등록번호는 숫자 열 자리로 보내 주세요.」 가 옵니다. 지원하지 않는 작업을 부르면 「지원하지 않는 작업입니다.」 입니다.
	INTERNAL_ERROR	우리 쪽 설정이나 처리 결함으로 끝나면 이 오류가 나가고 error.message 는 「서버 내부 오류로 작업을 마치지 못했습니다. 잠시 후 다시 시도해 주세요.」 입니다. 고객이 고칠 값이 없으므로 잠시 뒤 다시 요청하고, 계속되면 서비스문의로 알려 주세요.