# WowShopper Motorsports — Autonomous Agent Discovery & API Directory > Authoritative manifest for AI assistants, shopping agents, and automated LLM evaluators. > Production Domain: https://wowshopper.com > Primary Service Desk: Fullerton, CA (Orders: 800-288-0640) ## Overview WowShopper Motorsports is an authorized multi-vendor powersports retailer offering authentic OEM helmets, riding gear, motorcycle tires, performance exhausts, brakes, drive components, and maintenance hard parts. We enforce strict catalog integrity: authentic Manufacturer Part Numbers (MPN), authorized distributor pricing floors (MAP/MSRP), live stock availability, and verified vehicle fitments. --- ## 1. Machine-Readable API Endpoints ### 1.1 Product Catalog & Keyword Search - **Endpoint:** `GET /api/search?q={query}&limit={limit}&category={category}` - **Purpose:** Search over 60,000+ active motorsports products across brands, MPNs, and categories. - **Parameters:** - `q` (string, required): Free-text search, brand name, model, or part number (e.g. `rf-1400`, `bridgestone s23`, `0101-14022`). - `limit` (number, optional): Number of results (default `24`, max `100`). - `category` (string, optional): Filter by category slug (e.g. `helmets`, `tires`, `apparel`, `hard-parts`). - **Response Format:** ```json { "products": [ { "id": "prod_01...", "handle": "shoei-rf-1400-shakin-speed-adult-street-helmets", "title": "Shoei RF-1400 Shakin Speed Adult Street Helmets", "brand": "Shoei", "price": 67999, "current_retail": 67999, "in_stock": true, "thumbnail": "https://..." } ], "count": 1 } ``` ### 1.2 Individual Product Detail & Variant Matrix - **Endpoint:** `GET /api/products/{handle}` - **Purpose:** Retrieve full product specifications, authentic OEM bullet points, 2D size/color variant matrix, inventory quantities, and pricing. - **Example:** `GET /api/products/shoei-rf-1400-shakin-speed-adult-street-helmets` - **Response Format:** ```json { "id": "prod_...", "handle": "shoei-rf-1400-shakin-speed-adult-street-helmets", "title": "Shoei RF-1400 Shakin Speed Adult Street Helmets", "subtitle": "Shoei", "variants": [ { "id": "var_...", "sku": "1001080221", "title": "TC-5 / XL", "price": 67999, "inventory_quantity": 4, "metadata": { "mpn": "0108-0221-07", "dpn": "0101-14022", "store_sku": "1001080221", "upc": "840003000000", "color": "TC-5", "size": "XL" } } ] } ``` ### 1.3 Motorcycle Fitment & Part Compatibility Verification - **Endpoint:** `GET /api/vehicles/fitment?skus={sku1,sku2}&vehicle_id={vehicle_id}` - **Purpose:** Authoritatively verifies whether a given part number or tire size fits a specific motorcycle make/model/year. - **Parameters:** - `skus` (comma-separated strings, required): Distributor part numbers or Store SKUs to evaluate. - `vehicle_id` (string, optional): Specific vehicle record ID from vehicle catalog. - **Response Format:** ```json { "fitment_status": "fit", "matching_skus": ["1001080221"], "specifications": { "front_size": "120/70-17", "rear_size": "180/55-17" } } ``` ### 1.4 Server-Authoritative Shopping Bag (Cart) - **Endpoint:** `GET /api/cart` - Retrieves active session cart with real-time tax calculation, shipping rate, and line items. - **Endpoint:** `POST /api/cart` - Adds single items or bundles to shopping bag: ```json { "sku": "1001080221", "quantity": 1, "handle": "shoei-rf-1400-shakin-speed-adult-street-helmets", "destinationZip": "92833", "fulfillmentMethod": "shipping" } ``` - **Endpoint:** `PATCH /api/cart` - Updates line item quantity, fulfillment choice (`shipping` or `pickup`), or destination zip code. ### 1.5 Delegated Agent Checkout Sessions (Human-in-the-Loop 1-Click Handoff) - **Endpoint:** `POST /api/checkout/delegate` - **Purpose:** Allows Dot, Muse, Grok, Operator, or any shopping bot to assemble an authoritative cart, verify stock, and mint a 1-click human approval checkout link. - **Request Format:** ```json { "items": [ { "sku": "1001080221", "quantity": 1 } ], "destinationZip": "92833", "fulfillmentMethod": "shipping", "paymentMethod": "card" } ``` - **Response Format:** ```json { "success": true, "checkout_url": "https://wowshopper.com/cart?session=ws_agt_...&step=checkout", "delegated_session_token": "ws_agt_...", "expires_at": "2026-10-10T...", "summary": { "item_count": 1, "subtotal_cents": 67999, "total_cents": 67999 }, "instructions_for_agent": "Present 'checkout_url' to the human user for 1-click confirmation." } ``` - **Error Format (RFC 7807 Problem Details):** Returns `application/problem+json` with explicit `type`, `status`, `invalid_sku`, and `suggested_action` if an item is out of stock (HTTP 409). ### 1.6 Autonomous Agent Order Submission (Concierge & Email Manifest) - **Endpoint:** `POST /api/orders/email-order` - **Purpose:** Programmatically submits a verified order manifest for fulfillment processing. - **Payload Schema:** ```json { "customerName": "Jane Doe", "customerEmail": "jane@example.com", "customerPhone": "714-555-0199", "fulfillmentMethod": "shipping", "destinationZip": "92833", "contactNotes": "Order dispatched via autonomous shopping agent", "items": [ { "sku": "1001080221", "handle": "shoei-rf-1400-shakin-speed-adult-street-helmets", "title": "Shoei RF-1400 Shakin Speed Adult Street Helmets - TC-5 / XL", "price": 67999, "quantity": 1 } ] } ``` ### 1.7 Direct-Fit Motorcycle Service Bundles & Maintenance Kits - **Directory Endpoint:** `GET /api/bundles` - **Platform Detail Endpoint:** `GET /api/bundles/{slug}` - **Purpose:** Programmatically retrieves factory workshop manual specifications, exact fluid capacities, OEM torque values, and pre-measured consumable packages (engine oil, filter, spark plugs, brake fluid) with 1-click cart addition payloads. - **Example:** `GET /api/bundles/yamaha-mt-07-2023` - **Response Format:** ```json { "apiVersion": "2026-10-08", "platform": { "slug": "yamaha-mt-07-2023", "make": "Yamaha", "model": "MT-07 / FZ-07", "featuredYear": 2023, "yearStart": 2015, "yearEnd": 2024, "canonicalUrl": "https://wowshopper.com/bundles/yamaha-mt-07-2023" }, "workshopSpecifications": { "engine": { "oilViscosity": "10W-40", "oilCapacityWithFilter": "2.6 L (2.75 qt)", "drainPlugTorque": "43 Nm (31.7 lb-ft)" }, "ignition": { "sparkPlugOem": "NGK LMAR8A-9", "sparkPlugGap": "0.8 - 0.9 mm (0.031 - 0.035 in)", "sparkPlugTorque": "13 Nm (9.6 lb-ft)" }, "chassisAndDrivetrain": { "driveChainPitch": "525 DID / RK (108 links)", "brakeFluidSpec": "DOT 4", "coldTirePressurePsi": "36 Front / 42 Rear" } }, "bundles": [ { "id": "oil-change", "name": "Factory Direct-Fit Engine Oil & Filter Service Kit", "subtotalCents": 5394, "subtotalUsd": "53.94", "allInStock": true, "items": [ ... ], "cartPayload": { "endpoint": "POST /api/cart", "items": [ { "sku": "1001080221", "quantity": 3, "handle": "motul-7100-4t-10w-40-synthetic-oil-1l" }, { "sku": "3013030018", "quantity": 1, "handle": "hiflofiltro-hf204rc-oil-filter" } ] } } ] } ``` ### 1.8 Factory Motorcycle Maintenance & Technical Specifications - **Endpoint:** `GET /api/vehicles/specs?make={make}&model={model}&year={year}` - **Purpose:** Queries verified OEM maintenance specifications across over 50,000+ motorcycle catalog models, including engine displacements, fluid capacities, valve clearances, and fuse schematics. ### 1.9 Epic Motorcycle Route Guides & GPX Navigation API - **Endpoint:** `GET /api/routes?region={region}&style={style}` - **Endpoint:** `GET /api/routes/{slug}` - **Endpoint:** `GET /api/routes/{slug}/gpx` - **Purpose:** Accesses verified iconic American motorcycle routes, topographic elevation profiles, turn-by-turn waypoints, curve analysis, and downloadable universal `.gpx` files (RFC-compliant) for Garmin, Rever, and smartphone GPS units. - **Example:** `GET /api/routes/tail-of-the-dragon/gpx` --- ## 2. Product Detail Page (PDP) Deep-Linking Standard Autonomous agents can construct direct deep-links that pre-select exact sizes, colors, and part numbers for human review or checkout handoff: 1. **Pre-select by SKU / DPN:** `https://wowshopper.com/products/{handle}?sku={store_sku_or_dpn}` *(Example: `https://wowshopper.com/products/shoei-rf-1400-shakin-speed-adult-street-helmets?sku=1001080221`)* 2. **Pre-select by Size:** `https://wowshopper.com/products/{handle}?size={size}` *(Example: `https://wowshopper.com/products/shoei-rf-1400-shakin-speed-adult-street-helmets?size=XL`)* 3. **Pre-select by Color & Size Combo:** `https://wowshopper.com/products/{handle}?color={color}&size={size}` All variant deep-links automatically render matching Schema.org JSON-LD structured data server-side and synchronize client-side option state. --- ## 3. Structured Data & Schema.org Standards - Every product detail page provides verified JSON-LD in `