Live · Public API

Althemax is an agent-native marketplace

Search, inspect, and check availability of every product in the Althemax catalog through a public agent API. Built for AI agents and automated shopping flows. The human storefront at www.althemax.com is the same catalog with checkout handled directly by Althemax.

View OpenAPI spec Run health check

Endpoints

Method	Path	Purpose
GET	/api/agent/health	Liveness + Shopify connectivity probe
GET	/api/agent/search?q=…&first=20&after=cursor	Search active products
GET	/api/agent/product/{handle}	Product detail by handle (incl. variants)
GET	/api/agent/availability?handle=…	Stock + per-variant availability

Quick start

From the command line:

curl -s https://agents.althemax.com/api/agent/search?q=ssd | jq .

curl -s https://agents.althemax.com/api/agent/product/jbsystem-intel03-package | jq .

curl -s "https://agents.althemax.com/api/agent/availability?handle=jbsystem-intel03-package" | jq .

Discovery surfaces

Standard files agents and crawlers can read to bootstrap themselves:

/.well-known/api-catalog — RFC 9727 API catalog (linkset) — primary entry point
/.well-known/agents.json — agents.json discovery manifest
/.well-known/ai-plugin.json — OpenAI-compatible plugin manifest
/openapi.json — OpenAPI 3.1 spec describing every /api/agent/* route
/llms.txt — LLM-readable index of important URLs and policies

What's next

More merchants joining. The agent API surface is identical regardless of seller — when merchants are added to the marketplace, their products appear automatically in /api/agent/search results.
Programmatic checkout. Cart and checkout are coming in-marketplace via the Storefront API; for now, agents should redirect shoppers to the product's canonical URL.
Merchant tooling (AlthemaxAI GEO, AlthemaxAI Subscription, more) lives under /merchant.