REST API · Pro/Enterprise 전용

REST API 문서

내부 ERP·CRM과 연동하시거나 커스텀 대시보드를 만드실 때 사용하는 REST API 스펙입니다.
Bearer 토큰 인증, JSON 응답, RESTful 설계.

Beta 준비 중 안내
API는 Pro 플랜 정식 오픈과 함께 순차 공개됩니다. 아래 스펙은 Beta 초안이며 실 배포 전 변경될 수 있습니다. Beta 참여 희망 시 상담 신청으로 문의해 주세요.

인증

Bearer Token

요청 헤더에 Authorization: Bearer YOUR_API_KEY 형식으로 전달합니다.

IP 화이트리스트

Enterprise 플랜은 허용 IP 대역을 지정하실 수 있습니다. 침해 사고 발생 시 자동 차단됩니다.

Rate Limit

Pro 100 req/min · Enterprise 1,000 req/min 기본. 초과 시 429 응답과 Retry-After 헤더 반환.

Quick Start

curl 로 첫 요청 보내기

Shell

curl -X GET "https://api.나라장터.kr/v1/bids?keyword=IT용역&region=서울&maxAmt=500000000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Response · 200 OK

{
  "total": 42,
  "page": 1,
  "items": [
    {
      "noticeNo": "R26BK01617419-000",
      "title": "2026 통합대입상담시스템 기능 개선",
      "agency": "제주특별자치도체육회",
      "bsnsDiv": "물품",
      "estimatedPrice": 205454545,
      "closeAt": "2026-07-30T16:00:00+09:00",
      "openAt": "2026-07-30T16:00:00+09:00",
      "detailUrl": "https://www.g2b.go.kr/...",
      "matchedKeywords": ["시스템", "IT용역"]
    }
  ]
}

Endpoints

Base URL: https://api.나라장터.kr

GET/v1/bids입찰공고 조회 (키워드·기관·업종·금액 필터)Pro 이상

GET/v1/bids/{noticeNo}특정 공고 상세 조회Pro 이상

GET/v1/keywords내 키워드 목록 조회Pro 이상

POST/v1/keywords키워드 추가 (필터 조합 포함)Pro 이상

DELETE/v1/keywords/{id}키워드 삭제Pro 이상

GET/v1/statistics/winners낙찰 통계 (발주기관·업종·금액대별)Pro 이상

GET/v1/statistics/competitors경쟁사 낙찰 이력 조회Enterprise

POST/v1/reports리포트 생성 요청 (주간·월간)Enterprise

GET/v1/teams팀 계정 목록·권한 조회Enterprise

POST/v1/webhooks커스텀 웹훅 등록 (신규 매칭 이벤트 전송)Enterprise

SDK · 언어 지원

공식 지원 (예정)

Node.js / TypeScript

@narajangteo/sdk

Beta 예정

Python

pip install narajangteo

Beta 예정

Java

Maven Central

Enterprise 요청 시

go get github.com/…

Enterprise 요청 시

지원 언어 요청은 상담 신청으로 알려주세요.

API 접근이 필요하신가요?

Pro 플랜부터 API 접근이 가능합니다. 팀·API·리포트 자동화가 필요하시면 Enterprise 상담을 신청해 주세요.

Pro 자세히 보기 Enterprise 상담