DIMA Tools API로그인/회원가입
공공입찰라플라스 듀오

나라장터 전용 입찰가 API

고객사마다 따로 학습한 라플라스 듀오의 입찰가를
납품한 입찰 시스템에서 조회합니다.

원 단위 전용 입찰가공고 상태 6종개찰 후 순위고객사별 API 키
라플라스 엔진이 학습한 개찰 공고
270만건
킬러 입찰가
47,626건
킬러 입찰가 비율
11.7%

킬러 입찰가: 실제 낙찰하한가 이상이면서 개찰 1위 투찰가 이하인 예측가. 2025년 1월~2026년 8월 개찰 공고 408,219건 기준(라플라스 AI)

라플라스 듀오

라플라스 AI가 잡고,
라플라스 듀오가 고객사에 맞춥니다

라플라스 AI가 공고마다 1위를 겨냥한 입찰가를 예측하고, 라플라스 듀오는 그 위에서 업종·지역·투찰 이력에 맞춰 고객사만의 최적 입찰가를 예측합니다.

공고 1건공고번호로 요청
라플라스 AI1위를 겨냥한 예측가
라플라스 듀오고객사 업종·지역·투찰 이력
고객사 전용 입찰가고객사마다 다른 금액
웹과 같은 금액
디마툴즈 AI입찰과 동일같은 고객사의 같은 공고는 웹과 API가 같은 전용 입찰가를 냅니다.
고객사별 학습
고객사 1곳에 전용 AI 1개고객사의 업종, 지역, 투찰 이력으로 따로 학습합니다.
금액 단위
원 단위 그대로반올림하거나 천 원 단위로 올리지 않은 금액입니다.
엔진 표기
라플라스 듀오납품 시스템과 제안서에 엔진 이름을 밝혀도 됩니다.
제공 항목

공고번호 하나에
세 가지를 함께 요청합니다

요청 한 번에 공고 하나를 보내고, 필요한 항목을 골라 함께 요청합니다. 항목마다 결과가 따로 나옵니다.

price_unlock

고객사 전용 입찰가

그 고객사의 전용 입찰가가 원 단위 숫자로 나옵니다. 가격이 확정된 시각과 고객사가 처음 조회한 시각이 함께 나옵니다.

  • 같은 공고를 다시 요청해도 조회 건수는 늘지 않음
  • 가격이 다시 계산되면 바뀐 금액과 바뀐 시각
  • 대상 범위 밖 공고는 일반 예측가로 채우지 않음
"price_unlock": {
  "state": "ok",
  "premium_price": 1234567890,
  "premium_updated_at": "2026-11-11T06:40:12+09:00",
  "unlocked_at": "2026-11-10T14:42:05+09:00",
  "first_unlock": false
}
notice_status

공고 상태와 공고 정보

공고가 지금 어떤 상태인지 한 필드로 나옵니다. 정정 공고가 나오면 새 차수가 함께 나옵니다.

  • 공고 중 · 마감 · 개찰 완료 · 유찰 · 취소 · 정정
  • 입찰 마감 일시와 개찰 일시
  • 기초금액 · 추정가격 · 낙찰하한율
  • 지역 제한 · 업종 제한 · 나라장터 원문 링크
opening_result

개찰 결과와 순위

개찰이 끝나면 고객사의 실제 투찰 순위와, 전용 입찰가로 투찰했을 때의 순위가 함께 나옵니다. 납품한 시스템에서 투찰 결과를 바로 비교합니다.

  • 참가 업체 수 · 예정가격 · 1순위 금액과 투찰률
  • 고객사 실제 투찰 금액 · 순위 · 낙찰 여부
  • 전용 입찰가의 순위 · 낙찰하한가 미달 여부 · 1순위와의 차이

전용 입찰가 순위는 입찰 마감 전에 전용 입찰가를 조회한 공고에서 나옵니다. 개찰 명단에 고객사가 없으면 bid_found 가 false 로 나옵니다.

응답 필드 전체 ›
가격 변경

가격이 다시 계산된 공고만
골라서 조회합니다

정정 공고나 재계산으로 전용 입찰가가 바뀌면 바뀐 금액이 나옵니다. 납품한 시스템은 주기적으로 목록을 조회해 화면의 금액을 맞춥니다.

GET /unlocked

조회한 공고 목록

그 고객사가 지금까지 조회한 공고와 현재 전용 입찰가가 한 번에 나옵니다. since 에 시각을 넣으면 그 뒤에 가격이 확정되거나 다시 계산된 공고만 나옵니다.

  • 조회해도 서버 상태가 바뀌지 않음
  • 응답이 끊기면 같은 조건으로 다시 요청
  • cursor 로 다음 묶음 조회
GET /g2b/v1/unlocked?since=2026-11-11T09:00:00%2B09:00

{
  "items": [
    { "bid_ntce_no": "R26BK00000000",
      "bid_ntce_ord": "000",
      "premium_price": 1234567890,
      "premium_price_state": "ok",
      "premium_updated_at": "2026-11-11T06:40:12+09:00" }
  ],
  "next_cursor": null
}
GET /notices
AI 공고필터 공고 목록고객사 AI 공고필터에 맞는 진행 중 공고를 마감 임박 순으로 조회합니다.
GET /usage
호출량과 조회 건수오늘·이번 달 호출 수, 오늘 오류 수, 전용 입찰가 조회 건수가 나옵니다.
GET /company
키의 고객사이 키가 어느 고객사의 것인지 상호와 상태가 나옵니다.
GET /health
상태 점검키 없이 호출합니다.
키 구조

API 키 하나가
고객사 한 곳입니다

요청에 사업자등록번호를 넣지 않습니다. 키가 고객사를 정하므로 한 고객사의 키로 다른 고객사의 입찰가는 나오지 않습니다.

SI 시스템허용 IP에서 호출
A건설 키A건설 전용 입찰가
B건설 키B건설 전용 입찰가
C엔지니어링 키C엔지니어링 전용 입찰가

고객사 이름은 예시입니다.

고객사가 늘면 키를 추가계약한 고객사마다 전용 AI를 학습하고 키를 하나씩 발급합니다.
계약이 끝난 고객사 키만 폐기한 고객사의 계약이 끝나도 다른 고객사의 키는 그대로 동작합니다.
고객사별 호출량콘솔에서 고객사마다 호출 수와 조회 건수가 따로 나옵니다.
대상 공고

고객사가 투찰하는 공고가
대상입니다

전용 입찰가가 나오는 공고의 범위는 디마툴즈 AI입찰 웹과 같습니다. 고객사의 업종·지역 등 참가 조건에 맞는 공고입니다.

기본 범위참가 조건에 맞는 공고고객사의 면허·업종·지역 조건에 맞는 나라장터 공고에서 전용 입찰가가 나옵니다.
범위 밖 공고콘솔에서 제공 요청범위 밖이지만 실제로 투찰하는 공고는 콘솔에 공고번호를 적어 요청합니다. 반영된 공고는 같은 방식으로 조회합니다.
공동입찰고객사가 주관하는 공고 포함고객사가 주관하고 타사가 지분으로 참여하는 공고는 기본 범위입니다. 타사가 주관하는 공고는 별도 협의가 필요합니다.
마감 뒤마감 전에 조회한 공고만 유지마감이 지난 뒤 처음 요청한 공고는 전용 입찰가가 나오지 않습니다. 마감 전에 조회한 공고는 계속 나옵니다.
state뜻
ok전용 입찰가 제공
not_target고객사 투찰 가능 범위 밖
out_of_engine_scope전용 AI 대상이 아닌 공고(협상에 의한 계약·최저가 낙찰 등 입찰가를 계산하지 않는 낙찰 방식 포함)
closed마감 뒤 첫 요청
pending계산 중. 잠시 뒤 다시 요청
company_preparing고객사 전용 AI 학습 중
호출 예시

요청 한 번, 응답 한 번

공고번호와 요청 항목을 보내면 항목별 결과가 한 응답에 나옵니다.

요청

curl -X POST https://api.dima.tools/g2b/v1/requests \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"bid_ntce_no":"R26BK00000000",
       "items":["price_unlock","notice_status"]}'

응답

{
  "bid_ntce_no": "R26BK00000000",
  "bid_ntce_ord": "000",
  "results": {
    "price_unlock": {
      "state": "ok",
      "premium_price": 1234567890,
      "premium_updated_at": "2026-11-11T06:40:12+09:00"
    },
    "notice_status": {
      "state": "ok",
      "status": "open",
      "bid_close_at": "2026-11-14T10:00:00+09:00"
    }
  },
  "generated_at": "2026-11-11T10:00:00+09:00"
}
차수
bid_ntce_ord 생략 가능빼면 최신 차수로 조회합니다.
항목별 결과
한 항목이 실패해도 나머지 응답항목마다 state 가 따로 나옵니다.
호출 한도
분당 60회 · 하루 20,000회남은 횟수가 응답 헤더에 나옵니다.
요금

고객사 1곳 · 1년 1,290,000원

VAT를 포함한 금액입니다. 고객사 전용 AI 학습과 세 가지 제공 항목이 모두 들어 있습니다.

고객사 1곳 · 1년

1,290,000원VAT 포함

  • 라플라스 듀오 전용 AI 학습
  • 고객사 전용 입찰가
  • 공고 상태와 공고 정보
  • 개찰 결과와 순위
  • 고객사 전용 API 키

기본 호출 한도

하루 20,000회키별 분당 60회

  • 같은 공고 재조회는 조회 건수에 넣지 않음
  • 공고 상태·개찰 결과 조회는 조회 건수에 넣지 않음
  • 한도는 이용자별로 조정

API 계약에는 디마툴즈 AI입찰 웹 이용권이 들어 있지 않습니다. 웹 이용권은 디마툴즈 AI입찰에서 따로 구매합니다.

디마툴즈 AI입찰 ›
도입 절차

고객사 등록부터 연동까지

  1. API 이용 신청이 페이지의 API 이용 신청에서 고객사 상호와 사업자등록번호를 적어 신청합니다.
  2. 전용 AI 학습고객사의 업종·지역·투찰 이력으로 라플라스 듀오를 학습합니다. 학습 중에는 고객사 상태가 준비 중으로 나옵니다.
  3. 키 발급과 IP 등록학습이 끝나면 고객사 키를 발급하고 호출할 서버 IP를 등록합니다.
  4. 시스템 연동개발 문서의 규격에 맞춰 납품한 입찰 시스템에서 호출합니다.

연동 점검은 테스트 키로 합니다. 테스트 키는 테스트 전용 고객사에 연결되고 응답에 "test": true 가 붙습니다.

개발 문서 ›
질문

자주 묻는 질문

상품

디마툴즈 AI입찰 웹의 전용 입찰가와 같은 금액인가요?

같습니다. 같은 고객사의 같은 공고는 웹과 API가 같은 전용 입찰가를 냅니다.

일반 예측가도 나오나요?

이 상품은 고객사 전용 입찰가만 제공합니다. 대상 범위 밖 공고를 일반 예측가로 대신 채우지 않습니다.

사정률도 나오나요?

전용 입찰가는 원 단위 금액으로 나옵니다. 공고 상태 항목에서 기초금액과 낙찰하한율이 함께 나옵니다.

고객사 화면에 엔진 이름을 표시해도 되나요?

됩니다. 라플라스 듀오와 디마툴즈를 AI 모델 제공사로 밝혀도 됩니다.

요금·계약

여러 고객사에 납품하면 요금은 어떻게 되나요?

고객사 1곳마다 1년 1,290,000원(VAT 포함)입니다. 키도 고객사마다 따로 발급합니다.

전용 입찰가를 조회할 때마다 요금이 붙나요?

붙지 않습니다. 요금은 고객사 1곳 1년 단위입니다. 호출 한도는 키별 분당 60회, 하루 20,000회입니다.

한 고객사와 계약이 끝나면 어떻게 되나요?

그 고객사의 키만 폐기합니다. 다른 고객사의 키는 그대로 동작합니다.

연동

고객사가 투찰할 공고 목록도 나오나요?

GET /notices 로 고객사 AI 공고필터에 맞는 진행 중 공고가 마감 임박 순으로 나옵니다. 공고마다 전용 입찰가가 나오는 공고인지 표시되고, 전용 입찰가는 POST /requests 로 공고마다 요청합니다.

가격이 바뀐 것은 어떻게 아나요?

GET /unlocked 에 since 를 넣으면 그 시각 뒤에 가격이 확정되거나 다시 계산된 공고만 나옵니다. 응답의 premium_updated_at 으로 바뀐 시각을 비교합니다.

정정 공고는 어떻게 처리하나요?

공고 상태가 superseded 로 나오고 latest_ord 에 새 차수가 나옵니다. 차수를 빼고 요청하면 최신 차수로 조회합니다.

개찰 명단에 고객사가 없으면 어떻게 나오나요?

bid_found 가 false 로 나옵니다. 개찰 명단에서 고객사를 찾지 못했다는 뜻입니다.

범위 밖 공고는 어떻게 요청하나요?

콘솔의 범위 밖 공고 제공 요청에 고객사와 공고번호를 적습니다. 반영되면 같은 방식으로 조회합니다.

나라장터 전용 입찰가 API

고객사 1곳 · 1년 1,290,000원 (VAT 포함)