Back to Home

API Documentation

Reference for all available endpoints.

Product Search

POST /v1/products/search

Search the product catalog across merchants. Accepts a query with optional context and reasoning effort level.

POST /experimental/v1/products/search

Experimental product search with additional features under development.

Product Details

POST /v1/products/details

Retrieve a canonical Schema.org product record by commerce ID.

Price Insights

POST /v1/price-insights/analyze

Analyze product pricing with buy-timing recommendations, price history, and competitive positioning.

Business Discovery

POST /v1/ucp/discover

Discover UCP-compliant businesses via semantic search. Returns matching businesses with endpoints and supported protocols.

Commerce UCP

POST /v1/commerce_ucp

Resolve a seller URL to its Commerce UCP endpoint for checkout session management.

POST /v1/ucp/search/enriched

Search products with UCP business enrichment. Returns products from discovered UCP-enabled businesses.

GET /businesses/{business_id}/.well-known/ucp

Proxy a registered business's UCP profile from its external endpoint.

A2A Agent

GET /.well-known/agent-card.json

Agent card discovery. Returns the agent's capabilities, supported skills, and connection metadata.

POST /

JSON-RPC 2.0 task invocation. Supports 11 commerce skills including catalog search, checkout orchestration, order tracking, and more.

Health

GET /ping

Health check endpoint. Returns a simple JSON response confirming the service is running.

Request Headers

Common Headers

Product endpoints accept: X-Correlation-ID for request tracing, X-Market for locale (default: en-us), User-Agent, and Referer.