CommerceRail
For developers

One small API. Every agent surface.

If your store isn't on Shopify or Wix, plug in directly: push products with one endpoint, and CommerceRail handles normalization, agent feeds, protocol churn and analytics.

1 · Create an account, get a key

Sign up self-serve; your API key is issued once at signup (rotate any time).

POST /v1/auth/signup
{ "businessName": "Café Aruba", "email": "owner@cafe.aw", "password": "••••••••" }

→ { "token": "rs_…", "apiKey": "rk_live_…", "merchant": { "slug": "cafe-aruba-1a2b" } }

2 · Push your catalog

Idempotent upsert on your own product IDs - re-send anytime, no duplicates.

POST /v1/products            x-api-key: rk_live_…
{
  "externalId": "menu-042",
  "title": "Chicken Roti",
  "description": "Slow-braised chicken in a flaky, hand-rolled roti.",
  "priceCents": 1250,
  "currency": "USD",
  "imageUrl": "https://cdn.example.com/roti.jpg"
}

3 · You're discoverable

Your products are now in the agent feed and cross-merchant search - the surfaces AI agents read - with visibility scoring and AI-traffic analytics on top.

GET /agent/feed/cafe-aruba-1a2b        ← what every AI agent reads
GET /agent/search?q=roti               ← cross-merchant discovery
GET /v1/visibility                     ← your Agent Visibility Score
GET /v1/agent-traffic                  ← classified AI-agent visits

Interactive API docs

Full OpenAPI reference (every endpoint, schemas, auth) ships with the API at /docs. Webhook-verified platform connections, payment orchestration and checkout protocols are documented there as they ship.

Get your API key