{"openapi":"3.1.0","info":{"title":"SuntekStore catalog API","version":"1.0.0","description":"Hard-to-find gear, found. Read-only catalog for AI agents and shopping assistants. Buying happens on Stripe Checkout via the /buy link; this API never takes payment. Rate limit: 120 requests per minute per IP.","contact":{"email":"support@suntekstore.com"}},"servers":[{"url":"https://suntekstore.com"}],"paths":{"/products.json":{"get":{"operationId":"searchProducts","summary":"Search and list products","parameters":[{"name":"q","in":"query","required":false,"description":"Keywords (matched against product titles)","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Category slug","schema":{"type":"string","enum":["billiards","boating","fishing-camping","music","fitness","cycling-garage","crafts","workshop","hobbies","farm-garden","more"]}},{"name":"min_price","in":"query","required":false,"description":"Minimum price in USD","schema":{"type":"number"}},{"name":"max_price","in":"query","required":false,"description":"Maximum price in USD","schema":{"type":"number"}},{"name":"in_stock","in":"query","required":false,"description":"Only in-stock items","schema":{"type":"boolean"}},{"name":"sort","in":"query","required":false,"description":"Sort order","schema":{"type":"string","enum":["relevance","price_asc","price_desc","newest"]}},{"name":"page","in":"query","required":false,"description":"Page number (1-based)","schema":{"type":"integer","minimum":1}},{"name":"per_page","in":"query","required":false,"description":"Items per page","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"A page of products","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"per_page":{"type":"integer"},"pages":{"type":"integer"},"next":{"type":"string","format":"uri"},"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}}}},"400":{"description":"Invalid parameters"},"429":{"description":"Rate limited"}}}},"/products/{sku}.json":{"get":{"operationId":"getProduct","summary":"Get one product","parameters":[{"name":"sku","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"404":{"description":"Not found or no longer sold"}}}},"/p/{sku}.md":{"get":{"operationId":"getProductMarkdown","summary":"Plain-text facts sheet for one product","parameters":[{"name":"sku","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Markdown","content":{"text/markdown":{}}}}}},"/categories.json":{"get":{"operationId":"listCategories","summary":"Categories (shop by passion) with counts","responses":{"200":{"description":"Categories","content":{"application/json":{}}}}}},"/policies.json":{"get":{"operationId":"getPolicies","summary":"Shipping, returns, tax, payment and how-to-buy","responses":{"200":{"description":"Policies","content":{"application/json":{}}}}}},"/buy/{sku}":{"get":{"operationId":"startCheckout","summary":"Redirects the shopper to Stripe Checkout for this product (open in the shopper's browser)","parameters":[{"name":"sku","in":"path","required":true,"schema":{"type":"string"}},{"name":"qty","in":"query","required":false,"description":"Quantity (1 to max_quantity_per_order)","schema":{"type":"integer","minimum":1,"maximum":10}}],"responses":{"302":{"description":"Location: https://checkout.stripe.com/..."},"400":{"description":"Bad quantity"},"409":{"description":"Out of stock"},"410":{"description":"No longer sold"},"429":{"description":"Rate limited"}}}},"/mcp":{"post":{"operationId":"mcp","summary":"Model Context Protocol endpoint (JSON-RPC 2.0, Streamable HTTP, read-only)","requestBody":{"content":{"application/json":{}}},"responses":{"200":{"description":"JSON-RPC response"}}}}},"components":{"schemas":{"Product":{"type":"object","properties":{"id":{"type":"string"},"sku":{"type":"string"},"display_title":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"object"},"product_category":{"type":"string"},"brand":{"type":"string"},"condition":{"type":"string"},"price":{"type":"string","example":"130.99 USD"},"price_amount":{"type":"string"},"currency":{"type":"string"},"price_valid_until":{"type":"string","format":"date"},"availability":{"type":"string","enum":["in_stock","out_of_stock"]},"inventory_quantity":{"type":"integer"},"max_quantity_per_order":{"type":"integer"},"shipping":{"type":"string","example":"US:ALL:Standard Shipping:7-15:0.00 USD"},"delivery_days":{"type":"object"},"ships_to":{"type":"array","items":{"type":"string"}},"shipping_cost":{"type":"string"},"return_window_days":{"type":"integer"},"package_dimensions_cm":{"type":["array","null"]},"weight_g":{"type":["number","null"]},"image_link":{"type":"string","format":"uri"},"additional_image_link":{"type":"array","items":{"type":"string"}},"link":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"json_url":{"type":"string","format":"uri"},"buy_url":{"type":"string","format":"uri"}}}}}}