Procurement software access

Connect purchasing software to China supplier search

Read public buying opportunities and supplier profiles, or run a structured order check with an approved service key. Buyer contacts, full RFQs, quotes, chat messages, and account data stay private.

Public endpoints

The definitions below are public. Saving an order request, contacting a supplier, or opening a trade room requires sign-in.

GET

/.well-known/agent-card.json

Service identity, supported order checks, data limits, and documentation links.

GET

/api/v1/capabilities

Public list of order and supplier checks with JSON input, output, role, language, and access rules.

GET

/api/v1/capabilities/{capability_id}

Returns one definition by ID. An unknown ID returns 404.

GET

/api/v1/public/opportunities

Redacted buying opportunities. Buyer names, contacts, source URLs, notes, and full RFQs are excluded.

GET

/api/v1/public/suppliers

Buyer-readable supplier profiles without contacts, messages, quotes, or account identifiers.

Run a check

Approved partners can execute any catalog item. Send the service key and a unique retry key with each request.

POST /api/v1/capabilities/sourcing-brief-quality-check/execute
X-API-Key: your-service-key
Idempotency-Key: order-check-20260831-001
Content-Type: application/json

{
  "caller_role": "buyer_agent",
  "target_role": "supplier_agent",
  "language": "en",
  "source": "partner_name",
  "input": {"request_text": "Need 500 FCC-ready Bluetooth earbuds for Canada"}
}

The response includes an execution ID, status, confidence, fields that still need checking, and a structured result. Retrying the same request with the same key returns the stored response.

Add the order check to a partner website

The embedded form shows order completeness and an anonymous supplier count. It does not share buyer or supplier contacts with the host website.

<script src="https://maplebridge.io/sourcing-widget.js"
  data-partner="your-site"
  data-lang="en"></script>

Buyer and supplier roles

Send the buyer or supplier role separately from the request text. A buyer asking for suppliers must remain a buyer request.

{
  "capability_id": "sourcing-brief-quality-check",
  "caller_role": "buyer_agent",
  "target_role": "supplier_agent",
  "language": "en",
  "request_text": "Need 500 FCC-ready Bluetooth earbuds for Amazon US"
}

Predictable JSON

Each definition includes a fixed ID, version, JSON schema, example, error name, access rule, and data policy.

Customer data stays private

Public endpoints return definitions and examples only. Buyer identities, supplier contacts, RFQs, quotes, and messages are not included.

Works independently

Procurement software and agent platforms can read the public definitions without controlling MapleBridge accounts, orders, or customer data.

Account required for transactions

A public definition is not an open transaction endpoint. Check the authentication field before saving an order, contacting a supplier, or sending a message.