Service
나라장터(KONEPS) 공식 공사·용역·물품·외자 입찰공고를 검색하고, 기초금액·참가 제한·변경 이력 조회에 쓰는 정규화된 선택자를 제공합니다.
99.43%30일 가동률평균 응답508ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-bid-notice/bid-notice-amounts | Retrieves base-price rows for a construction, service, or goods notice. Use when you already have a bid_notice_id from korea-bid-notice:search-bid-notices and need its base amount or reserve-price percentage range. Pass bid_notice_id (and optionally round) verbatim; omit round to get every amount round. Do NOT use for license or region constraints — use korea-bid-notice:bid-notice-constraints instead — or for change history — use korea-bid-notice:bid-notice-changes instead. Foreign notices are rejected because KONEPS has no foreign base-amount operation. Returns items, each with bid_notice_id, round, base_price_krw, and price_range_pct (minimum and maximum percent). | |
| POST | /v1/korea-bid-notice/bid-notice-changes | Lists construction, service, or goods notice changes by change-time range or by notice selector. Use when you need the change history of a known bid_notice_id (title, bid-opening, or qualification-registration datetime changes) or every change recorded in a datetime range. Pass bid_notice_id (and optionally round) verbatim, or omit both and use from_datetime and to_datetime; notice-ID mode rejects datetime fields, and omitted datetime bounds use a seven-day window. Do NOT use to find notices — use korea-bid-notice:search-bid-notices instead — or for base amounts or participation constraints — use korea-bid-notice:bid-notice-amounts or korea-bid-notice:bid-notice-constraints instead. Foreign notices are unsupported because KONEPS exposes no foreign change-history operation. Returns items (each with bid_notice_id, round, changed_at, change_category, changed_field, previous_value, and new_value) and summary pagination metadata. Rows are ordered oldest first by change time, so the most recent changes are on the last page. | |
| POST | /v1/korea-bid-notice/bid-notice-constraints | Combines official KONEPS license-limit and eligible-region rows for one notice round. Use when you need the license restrictions, allowed industries, or allowed participation regions for a known bid_notice_id from korea-bid-notice:search-bid-notices. Pass business_type, bid_notice_id, and round verbatim; when round is omitted, it is resolved automatically only if the notice has exactly one round. Do NOT use for base amounts — use korea-bid-notice:bid-notice-amounts instead — or for change history — use korea-bid-notice:bid-notice-changes instead. A notice with no constraints returns two empty arrays. Returns license_constraints and allowed_regions. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/korea-bid-notice/search-bid-notices | Searches official KONEPS bid notices by normalized business type (construction, service, goods, or foreign), an optional title query, and a real minute-precision ISO 8601 posting-time range with timezone. Use when you need to find notices or to obtain the bid_notice_id and round selectors that the other operations require. Do NOT use for base amounts, participation constraints, or change history — use korea-bid-notice:bid-notice-amounts, korea-bid-notice:bid-notice-constraints, or korea-bid-notice:bid-notice-changes instead. Omitted datetime bounds use a seven-day window that stays fixed across cursor pages. Returns items (each with bid_notice_id, round, title, agency_name, posted_at, close_at, estimated_price_krw, and notice_url) and summary with a selector-consistent total_count, has_more, and an opaque next_cursor. Rows are ordered oldest first by posting time, so the newest notices are on the last page: narrow the datetime range, or raise limit toward 999, to reach them in fewer calls. |
