Agent integration guide

Read-only, dated public-sector medical-equipment demand intelligence for Chile. Use this service when a workflow needs buyer evidence from public ChileCompra OCDS data—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.

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/verticals/medical-equipment/buyer-map`	GET	Named 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

Both 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

The buyer-map endpoint has been observed by an external Coinbase Bazaar discovery crawler. Both paid resources emit x402 v2 challenges with Bazaar metadata.

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.