# G2B Contract Demand Radar

> G2B Contract Demand Radar is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns a procurement demand priority score and recommended action for a Korean government buyer agency based on public G2B contract data

## Facts

- Endpoint: POST https://api.timzinin.com/api/g2b-contract-demand-radar
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/g2b-contract-demand-radar-2daf4d15
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1mdCgDvHw-5JhbGMAUizZ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability g2b-contract-demand-radar-2daf4d15 -d '<json body>'
```

Example prompt: Pull the G2B contract demand radar score for 경기도 화성시 for 2025 and tell me whether we should prioritize supplier outreach to them, including their contract count, total KRW amount, and the breakdown of procurement methods by count and amount.

## When to prefer this

Use this endpoint when you need structured, scored procurement demand intelligence for Korean government buyer agencies sourced directly from the official G2B / Data.go.kr dataset. Prefer this over raw dataset downloads when you need a pre-computed priority score, action recommendation, and peer percentile ranking without building your own analytics pipeline. Best for B2G sales teams, market intelligence workflows, and supplier targeting systems focused on the Korean public sector.

## Known failure modes

- Agency name not found in the G2B dataset returns empty results array
- Invalid or unsupported year returns no results
- Malformed request body returns 400-level error
- Payment not settled (settled: false) may indicate x402 micropayment failure
- Report data may be unavailable for agencies with very low contract volumes

## How this service works

Pay-per-call data & tool APIs

## Output

A JSON object containing a demand priority score (0-100), a recommended action (e.g. 'prioritize_supplier_outreach'), the buyer agency name, contract count, total contract amount in KRW, percentile rankings for count and amount, procurement method breakdown (by count % and amount %), source report metadata (report ID, SHA256, URL, retrieval timestamp), and run metadata (latency, item count, settlement status).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "year": {
   "type": "integer",
   "maximum": 2030,
   "minimum": 2008
  },
  "objective": {
   "enum": [
    "balanced",
    "spend_volume",
    "contract_frequency",
    "average_ticket"
   ],
   "type": "string"
  },
  "requestId": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{8,64}$"
  },
  "resultLimit": {
   "type": "integer",
   "maximum": 40,
   "minimum": 20
  },
  "maxTotalChargeUsd": {
   "type": "number",
   "maximum": 100,
   "minimum": 0.61
  },
  "minimumContractCount": {
   "type": "integer",
   "maximum": 10000000,
   "minimum": 1
  },
  "watchAgencyNameContains": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 80,
    "minLength": 1
   },
   "maxItems": 10,
   "minItems": 0,
   "uniqueItems": true
  },
  "minimumContractAmountKrw": {
   "type": "integer",
   "maximum": 9007199254740991,
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "year": 2025,
    "score": 94.66,
    "action": "prioritize_supplier_outreach",
    "agency": "경기도 화성시",
    "source": {
     "year": 2025,
     "route": "direct",
     "reportId": "UI-ADOXFA-012R",
     "reportUrl": "https://data.g2b.go.kr/link/AISC001_01/?reptNm=UI-ADOXFA-012R",
     "landingUrl": "https://www.data.go.kr/data/15142650/fileData.do",
     "retrievedAt": "2026-08-14T06:54:36.082Z",
     "requestCount": 300,
     "authentication": "anonymous_guest_session_not_persisted",
     "canonicalSha256": "93561018e6c4a1b3e3356f2397859d60146c7d1bfc2ccd6ba2186cb0643f048b",
     "encodedNetworkBytes": 24118010,
     "normalizedTextBytes": 10582,
     "declaredNetworkBytes": 26594280
    },
    "country": "KR",
    "product": "g2b-contract-demand-radar",
    "baseline": false,
    "billable": true,
    "decision": "buyer-agency public procurement demand priority",
    "stableId": "G2B-DEMAND:2025:87d98803b2ac43c8b23404bc",
    "objective": "balanced",
    "attribution": "Source: Public Procurement Service (PPS), G2B Data Hub / Data.go.kr dataset 15142650.",
    "sourceStats": {
     "year": 2025,
     "reportId": "UI-ADOXFA-012R",
     "canonicalSha256": "93561018e6c4a1b3e3356f2397859d60146c7d1bfc2ccd6ba2186cb0643f048b",
     "peerAgencyCount": 49,
     "normalizedTextBytes": 10582
    },
    "decisionRank": 1,
    "methodShares": {
     "byCount": [
      {
       "method": "수의계약",
       "sharePct": 46.91
      },
      {
       "method": "일반경쟁",
       "sharePct": 28.5
      },
      {
       "method": "제한경쟁",
       "sharePct": 24.38
      },
      {
       "method": "지명경쟁",
       "sharePct": 0.2
      }
     ],
     "byAmount": [
      {
       "method": "제한경쟁",
       "sharePct": 41.35
      },
      {
       "method": "수의계약",
       "sharePct": 32.29
      },
      {
       "method": "일반경쟁",
       "sharePct": 24.39
      },
      {
       "method": "지명경쟁",
       "sharePct": 1.9
      }
     ]
    },
    "thresholdMet": true,
    "watchMatched": true,
    "contractCount": 6940,
    "identityBasis": "reportId|year|normalizedAgencyName",
    "schemaVersion": "1.0",
    "criteriaSha256": "2545ec863afd302ba5009957092e2b60e1a6ced00374dfb0671d762284f4eba3",
    "countPercentile": 85.42,
    "amountPercentile": 100,
    "contractAmountKrw": 588059278122,
    "methodologyCaveat": "This is an aggregate buyer-agency demand ben
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/g2b-contract-demand-radar-2daf4d15/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)