Everything is an API. Agents are first-class customers.
XBuyer is API-first by construction. The website is just one client — your agent is another. Every shopping action a human can take, an authorized agent can take through a documented, scoped interface.
One endpoint graph, end to end.
From discovery to doorstep, every step is callable — no browser automation required.
Semantic product search with category, price, and attribute filters.
Rich, agent-ready catalog with AI metadata, specs, and media.
Real-time stock and fulfillment availability per merchant.
Merchant profiles, policies, and catalog access.
Create, read, and mutate carts on behalf of an authorized user.
Initiate escrow-backed checkout without a human in the loop.
Inspect balance and authorize capped spends from an isolated wallet.
Place, track, and manage orders end-to-end.
Request and reconcile refunds within granted scopes.
Submit and read verified reviews.
Live fulfillment and logistics status updates.
Agent OAuth
Agents authenticate with scoped, revocable tokens. Users grant exactly the capabilities an agent needs — browse, compare, auto-buy, refund — and can withdraw them anytime from the dashboard.
- Scoped, short-lived access tokens
- Per-agent permission revocation
- Full audit trail of every call
- Spending caps enforced server-side
SDKs & protocols
First-party SDKs in the languages agents are built with, plus native Model Context Protocol (MCP) support so LLM tool-calling frameworks can shop through XBuyer directly.
Your first agent purchase in two calls.
Exchange credentials for a scoped token, then let the agent search and check out — funds settle in escrow.
// 1. Exchange your client credentials for a scoped agent token
curl https://api.xbuyer.com/v1/oauth/token \
-d client_id=$XBUYER_CLIENT_ID \
-d client_secret=$XBUYER_CLIENT_SECRET \
-d scope="product:read cart:write checkout:write"
// 2. Let an agent search, then place an escrow-backed order
curl https://api.xbuyer.com/v1/search?q=wireless+earbuds \
-H "Authorization: Bearer $AGENT_TOKEN"
curl https://api.xbuyer.com/v1/checkout \
-H "Authorization: Bearer $AGENT_TOKEN" \
-d '{ "items": [{ "productId": "p_8f2a", "quantity": 1 }] }'API reference
Full endpoint specs, schemas, and error codes.
Status & uptime
Real-time platform health and incident history.
Webhooks
Subscribe to order, fulfillment, and wallet events.
Build the agent that shops for you.
Create an account, generate scoped credentials, and connect your agent to a real commerce backend in minutes.