SuntekStore catalog

Search SuntekStore's catalog of hard-to-find specialty parts and tools (ships free to the US). Filter by keywords, hobby category, price range (USD) and maximum delivery days; sort by relevance, price, newest or fastest delivery (any sort other than relevance first groups results by how closely they match the query, then sorts within each group). Returns products with price, availability, delivery window, estimated delivery dates, return policy, Prop 65 warning and links. Descriptions are shortened here; get_product returns the full text. If filters exclude every match, filters_excluded_all says what exists without them.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords or a plain-English request, e.g. 'cue case', 'kayak motor mount' or 'waterproof bag for a kayak paddle under $30'"
    },
    "category": {
      "type": "string",
      "enum": [
        "billiards",
        "boating",
        "fishing-camping",
        "music",
        "fitness",
        "cycling-garage",
        "crafts",
        "workshop",
        "hobbies",
        "farm-garden",
        "more"
      ],
      "description": "Hobby category (shop by passion)"
    },
    "min_price": {
      "type": "number",
      "description": "Minimum price in USD"
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price in USD"
    },
    "in_stock_only": {
      "type": "boolean"
    },
    "max_delivery_days": {
      "type": "integer",
      "minimum": 1,
      "description": "Only items delivered within N days"
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "price_asc",
        "price_desc",
        "newest",
        "fastest_delivery"
      ]
    },
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "per_page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  }
}

Full facts for one product by SKU (e.g. ST-54137787): specs, price, stock, delivery, returns, links.

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string"
    }
  },
  "required": [
    "sku"
  ]
}

Store policies: shipping (US only, free), delivery times, 30-day returns, tax, payment, how to buy.

{
  "type": "object",
  "properties": {}
}

Validate SKU and quantity and return a link the shopper opens to pay on Stripe Checkout. This does not charge anything or reserve stock; the shopper completes payment themselves.

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string"
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "required": [
    "sku"
  ]
}

Put several products (with quantities) into one order and get a single Stripe Checkout link for the shopper. Every line is checked against current price, listing status and stock. The shopper opens the link, enters a US shipping address and pays; sales tax is added there. Nothing is charged by this call and stock is not reserved. Up to 12 different items.

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 12,
      "items": {
        "type": "object",
        "properties": {
          "sku": {
            "type": "string"
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10
          }
        },
        "required": [
          "sku"
        ]
      }
    }
  },
  "required": [
    "items"
  ]
}

Look up an order by order number (like ST2610010001) and the email used at checkout. Returns status, items, carrier, tracking number and estimated delivery. No personal details are returned.

{
  "type": "object",
  "properties": {
    "order_no": {
      "type": "string"
    },
    "email": {
      "type": "string"
    }
  },
  "required": [
    "order_no",
    "email"
  ]
}