Interface for AI agents
Agents are first-class consumers here, not an afterthought bolted onto a webpage. Every interface below returns protocol-neutral JSON, is readable without a key, and describes purchase paths in a merchant-agnostic shape so an agent can act without knowing which storefront sits behind it.
Start here
curl https://<host>/api/public/agent/v1/ curl "https://<host>/api/public/agent/v1/search?q=quiet+headphones+for+flights+under+%24300"
Endpoints
Capability discovery: everything an agent needs to plan a session.
OpenAPI 3.1 schema for tool generation.
- GET|POST/api/public/agent/v1/search
Natural-language search returning extracted constraints and ranked, explained results.
Filterable catalog listing (category, q, max_price, limit).
Full product intelligence: attributes, price history, purchase options.
Attribute matrix for 2-6 products.
Category taxonomy with product endpoints.
Prices, currency and availability.
Normalized purchase options with resolved destinations.
First-party checkout for owned digital products (not connected in this build).
Merchant neutrality
Purchase options carry a merchant, a marketplace, a purchase type and a resolved destination. Amazon appears as one merchant with an ASIN identity; a direct brand store or a first-party digital product appears with exactly the same shape. No agent needs Amazon-specific logic.
Verified or absent
Fields we have not verified are returned as null with no substitute. Offers carry a data source and a check timestamp so an agent can decide whether the number is fresh enough to act on.
Two purchase types
affiliate_redirect completes on the merchant's site through a tracked redirect. first_party_checkout completes here for owned digital products, and reports its connection status honestly rather than accepting orders it cannot fulfil.
Access and rate limits
Read interfaces are open and CORS-enabled with a 60-second cache. Crawling is welcome: the product feed at /api/public/feed/products exists so agents do not have to scrape HTML.