nylandersmattor.se

searchRugs

Search the Nylanders rug catalogue by free-text query with optional structured filters. Returns { results, totalMatches } where each result is { productId, name, slug (pass to getRugDetails), url, type, variants }. Each variant has: variantId (opaque id to pass to addToCart); type ('normal' = fixed-size, buy as-is; 'meter' = cut-to-length off a fixed-width roll; 'kvadratmeter' = cut to a custom width×length); colorName; sizeLabel (for normal: 'W x L cm'; for meter: a bare number = the roll width in cm; for kvadratmeter: descriptive, may be 'rund' for round); widthCm/lengthCm (numbers for normal, null for made-to-order since the size is chosen at addToCart); priceExVat and priceIncVat in SEK; currency; inStock (boolean); stockQty (a number, or null meaning quantity is untracked / made-to-order — null means AVAILABLE, not unavailable). Made-to-order variants also carry `constraints` = { width: { min, max }, length: { min, max } } in cm (a null bound = unbounded) — the valid range for the widthCm/lengthCm you pass to addToCart. Filter semantics: `color` matches Swedish catalogue colour names ('Rosa', 'Grön', 'Grå', …); English colour terms are NOT translated or matched, so supply the Swedish name. Width/length range filters apply to fixed-size (normal) variants only; made-to-order (meter/kvadratmeter) variants are NOT excluded by size filters since they can be cut to the requested size. `maxPriceSek` compares against the ex-VAT price. `inStockOnly` defaults true; `limit` defaults 10.

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search phrase (e.g. a rug name, colour, or style)."
    },
    "color": {
      "type": "string",
      "description": "Filter to variants matching this Swedish catalogue colour name (e.g. 'Rosa', 'Grön', 'Grå'). English colour terms are NOT translated or matched."
    },
    "minWidthCm": {
      "type": "number",
      "description": "Minimum rug width in centimetres."
    },
    "maxWidthCm": {
      "type": "number",
      "description": "Maximum rug width in centimetres."
    },
    "minLengthCm": {
      "type": "number",
      "description": "Minimum rug length in centimetres."
    },
    "maxLengthCm": {
      "type": "number",
      "description": "Maximum rug length in centimetres."
    },
    "maxPriceSek": {
      "type": "number",
      "description": "Maximum price in SEK, compared against the ex-VAT price."
    },
    "inStockOnly": {
      "type": "boolean",
      "description": "Only return variants that are in stock. Defaults to true."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of result products. Defaults to 10."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}