Agent integration guide

Read-only Chile public-procurement buyer intelligence for autonomous agents. Use it to discover and rank public-sector buyers for a product or service from ChileCompra OCDS evidence—not to submit bids, contact buyers or make procurement decisions automatically.

Recommended agent decision flow

Use POST /v1/buyers/search when the task starts from a product, service, supplier offering or buyer intent.
Use the free /v1/buyers/search/preview when the agent policy requires proof of coverage before spending.
Pay US$0.01 only when ranked buyer identities and procurement evidence improve the next action.
Keep the returned ChileCompra source URLs, period and limitations attached to downstream recommendations.

Primary primitive: buyer search

POST /v1/buyers/search
Content-Type: application/json

{
  "query": "hospitales que compran equipamiento médico",
  "region": "Región Metropolitana de Santiago",
  "limit": 5
}

Price: US$0.01. Coverage: all 8,004 July 2026 ChileCompra OCDS processes, representing 2,138 unique buyer IDs in the indexed population.

Free coverage check: POST /v1/buyers/search/preview.

Free buyer-search preview

POST /v1/buyers/search/preview
Content-Type: application/json

{
  "query": "equipamiento de laboratorio",
  "region": "Región Metropolitana de Santiago",
  "limit": 5
}

Use this first to confirm that the indexed ChileCompra population contains relevant demand before paying.

Try the free medical-equipment preview

curl https://exp-100k-001-v2.vercel.app/v1/verticals/medical-equipment/preview

The response includes data freshness, public provenance, aggregate demand signal and the exact paid unlock before an agent spends.

Paid resources

Resource	Method	Use	Price
`/v1/buyers/search`	POST	Primary primitive: search and rank Chile public-sector buyers for a product, service or intent.	US$0.01
`/v1/verticals/medical-equipment/buyer-map`	GET	Named healthcare buyers, observed tender frequency and deterministic provenance.	US$0.01
`/v1/opportunities/match`	POST	Match a supplier need to structured public-demand evidence.	US$0.05

All paid resources answer an unpaid request with an x402 v2 402 Payment Required challenge. Pay the exact amount in USDC on Base (eip155:8453) with an x402-capable client, then retry the original request with its payment payload. No API key or account is required.

Inspect before paying

curl -i https://exp-100k-001-v2.vercel.app/v1/verticals/medical-equipment/buyer-map

The unpaid response exposes the exact amount, Base network, USDC asset, recipient, EIP-3009 transfer method and Bazaar discovery metadata. Agents should verify those fields and enforce their own spend caps before signing.

Opportunity match input

POST /v1/opportunities/match
Content-Type: application/json

{
  "need": "Vendemos ecógrafos y equipamiento clínico en Chile",
  "region": "Región Metropolitana de Santiago",
  "max_results": 10
}

Inspect the machine-readable payment contract · unpaid self-test

Discovery status

External Coinbase Bazaar discovery activity has been observed. Paid resources emit x402 v2 challenges with Bazaar metadata; the primary commercial primitive is now POST /v1/buyers/search at US$0.01.

Trust and scope

Every response should be evaluated with its stated period, coverage and provenance. The service draws on public information from Dirección ChileCompra in OCDS format. It is not a substitute for source-notice review, legal advice or procurement due diligence.