Find products
suppco_find_productsRead-onlyIdempotent
Find products based on user query - handles search, browsing, and recommendations. Use this whenever the user wants to discover or find products.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| form | No | Comma-separated list of product forms. Valid forms are: capsule, tablet, softgel, gummy, powder, liquid, other (e.g., 'capsule,tablet') | |
| brand | No | The brand a user prefers | |
| limit | No | Maximum number of products to return (default: 5, max: 50) | |
| query | No | Free text search for a specific product by name (e.g., "Thorne Creatine", "AG1 Greens"). Only use this when searching for a specific brand + product name with no filters. Do NOT use query together with other params — use product_category_name instead when filters like priority, brand, certifications, form, max_price, or servings are needed. | |
| offset | No | Number of products to skip for pagination (default: 0) | |
| tested | No | When true, only return products that have been TESTED by SuppCo (identity, potency, and/or heavy metals testing performed by SuppCo's lab) | |
| priority | No | How to rank results. Valid: best_value, most_trusted, most_popular, most_expensive. Omit (or leave blank) to apply the user's profile buying preference automatically; pass a value to override. | |
| servings | No | Comma-separated list of serving counts (e.g., '30,60,90') | |
| max_price | No | Maximum price in dollars (e.g., 50.00) | |
| certifications | No | Required certifications, comma-separated. Valid: gluten_free, non_gmo, vegan_action, usda_organic, nsf_sport, usp_verified, informed_sport, informed_choice, tested_by_suppco. Omit (or leave blank) to apply the user's profile dietary preferences (vegan, gluten-free) automatically; pass an explicit list to override. | |
| exclude_ingredients | No | Comma-separated list of ingredients the product must NOT contain (e.g., 'stevia,sucralose'). Matches against both active ingredients (supplements) and inactive ingredients (excipients). | |
| include_ingredients | No | Comma-separated list of ADDITIONAL ingredients the product must also contain beyond its category (e.g., for 'collagen with hyaluronic acid', set product_category_name='Collagen' and include_ingredients='hyaluronic acid'). Do NOT put the primary supplement here — use product_category_name for that. | |
| product_category_name | No | REQUIRED for all non-query searches. The supplement category (e.g., 'Vitamin D', 'Magnesium', 'Ashwagandha', 'Collagen'). ALWAYS provide this when using any filter params (priority, brand, certifications, form, max_price, servings, include_ingredients, exclude_ingredients). When the user asks for a supplement by name like 'ashwagandha' or 'magnesium', that IS the category. |