search_products
Search the SF Supplies product catalog for vinyl, films, and signage supplies. Use free-text queries or filter by attributes, stock, and product status to find products with availability information.
Instructions
Search the SF Supplies product catalog (vinyl, films, signage supplies, etc.). Returns matching products with their name, page URL, stock status, product status, and attributes (Brand, Color, Size, Material, Finish, Series, …). Use the optional 'filters' to narrow by attribute — call list_product_filters first if you need to know which attributes/values are available. Two distinct availability signals: 'in stock' reflects inventoryQty — whether the item is ACTUALLY in stock in the warehouse right now (yes/no). 'status' is the catalog classification: StockItem (normally stocked), InHouse (made/held in house), NonStock (orderable, not stocked), Discontinued (no longer offered), Development (not yet released), or Null. A product can be a StockItem yet currently out of stock — when asked about availability, use 'in stock' (inventoryQty), not 'status'. To FILTER by these, pass 'in_stock' (true = only in-stock, false = only out-of-stock) and/or 'product_status'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Zero-based page index (default 0). | |
| search | Yes | Free-text query, e.g. 'Avery translucent vinyl'. May be empty to browse by filters/category alone. | |
| filters | No | Attribute filters to narrow results. Keys are facet field names (see list_product_filters), values are arrays of allowed values, e.g. {"Brand": ["Avery"], "Color": ["Plum"], "Size": ["15\" x 10 Yards"]}. Multiple values for one field are OR-ed; different fields are AND-ed. | |
| in_stock | No | Filter by real warehouse availability: true = only items currently in stock, false = only out-of-stock. Omit to include both. | |
| page_size | No | Results per page (1-50, default 8). | |
| sort_column | No | Column to sort by (optional; leave empty for relevance). | |
| category_slug | No | Restrict to a category by its slug (optional). | |
| product_status | No | Filter to one catalog status (StockItem, InHouse, NonStock, Discontinued, Development). Omit for all. Distinct from in_stock — a StockItem can be out of stock. | |
| sort_direction | No | 'asc' or 'desc' (optional). |