ShopVision Agentic Commerce API

v1.0

Machine-readable endpoints for AI agents. Browse, search, compare, and initiate purchases via ShopVision escrow. All data is structured for LLM consumption.

Protocol: ShopVision Agentic Commerce Protocol (ACP)

Payment Model

Escrow Protected

Buyer → ShopVision → Brand

Data Formats

Markdown + JSON + JSON-LD

Schema.org compatible

Agent Actions

Browse · Search · Compare · Buy

Supports MCP, llms.txt

Products

Brands

Endpoints

Catalog & Listings (JSON)

GET /agent/catalog.json Full catalog — everything in one call JSON

GET /agent/products.json All products listing JSON

GET /agent/brands.json All brands listing JSON

GET /agent/categories.json All categories listing JSON

GET /agent/questions.json All buying guides listing JSON

Detail Pages (Markdown)

GET /agent/products/{slug} Product details, specs, reviews MD

GET /agent/brands/{slug} Brand profile & product list MD

GET /agent/categories/{slug} Category overview & products MD

GET /agent/questions/{slug} Buying guide details MD

Discovery Files

GET /llms.txt LLM-friendly site summary TXT

GET /llms-full.txt Full content dump for LLMs TXT

GET /ai.txt AI crawling & training preferences TXT

GET /sitemap-index.xml XML Sitemap for all pages XML

Product Endpoints

12 items

ProGlide ProGlide Ergonomic Wireless Mouse $49.99 → MD ProGlide ProGlide Ultra-Light Gaming Mouse $64.99 → MD KeyCraft KeyCraft Mechanical Keyboard TKL $129.99 → MD KeyCraft KeyCraft Split Ergonomic Keyboard $189.99 → MD SoundSphere SoundSphere Pro Wireless Headphones $199.99 → MD SoundSphere SoundSphere Sport Earbuds $89.99 → MD PixelView PixelView 4K USB-C Monitor 27" $449.99 → MD PixelView PixelView Ultrawide Curved Monitor 34" $599.99 → MD ErgoSeat ErgoSeat Pro Mesh Office Chair $349.99 → MD StandDesk StandDesk Electric Standing Desk 60" $549.99 → MD ClearView ClearView 4K Webcam with AI Tracking $129.99 → MD ConnectHub ConnectHub USB-C Docking Station $89.99 → MD

Brand Endpoints

8 brands

ProGlide 2 products → MD KeyCraft 2 products → MD SoundSphere 2 products → MD PixelView 2 products → MD ErgoSeat 1 products → MD StandDesk 1 products → MD ClearView 1 products → MD ConnectHub 1 products → MD

Quick Start for AI Agents

# 1. Discover full catalog (one call)
GET https://structured-commerce.demo/agent/catalog.json

# 2. Or browse by resource type
GET https://structured-commerce.demo/agent/products.json
GET https://structured-commerce.demo/agent/brands.json
GET https://structured-commerce.demo/agent/categories.json
GET https://structured-commerce.demo/agent/questions.json

# 3. Read a specific product (markdown, no JS needed)
GET https://structured-commerce.demo/agent/products/proglide-ergonomic-wireless-mouse

# 4. Read LLM-friendly summary
GET https://structured-commerce.demo/llms.txt

# 5. Purchase (human confirms on ShopVision UI)
# Payment held in escrow → brand ships → buyer confirms → brand paid
BUY https://structured-commerce.demo/products/proglide-ergonomic-wireless-mouse

Compatible AI Platforms

ChatGPTClaudeGeminiPerplexityGoogle AI OverviewsCopilotCustom MCP Clients