search_beauty_prices

se.glowjakt/glowjakt · Verify this server

Search beauty products and get the lowest current price for each. Results are EAN-grouped: each product appears once, at the lowest price across all stores. Prices exclude shipping — for true landed cost (item + each store's actual shipping), follow up with compare_product_prices on the product_slug. A non-empty query is required unless at least one filter (category, key_ingredient, exclude_ingredient, exclude_controversial, attribute or max_price) is set — an empty query with filters browses the catalog. Two separate stock figures are returned for every product: store_count — stores that carry the product, including those currently sold out. in_stock_store_count — stores that have it in stock right now. When these differ, the product is listed more widely than it is currently available. lowest_price is always the lowest price among stores that can actually ship it, when any can. Supports ingredient-aware search: - "moisturizer with retinol" → key_ingredient="retinol" - "serum with retinol or vitamin C" → key_ingredient="retinol,vitamin-c" (OR) - "shampoo without sulfates and silicones" → exclude_ingredient="sls,silicones" - "clean / fragrance-free formulation" → exclude_controversial=True (excludes fragrance/parfum, parabens, silicones, SLS, mineral oil, formaldehyde, phenoxyethanol, propylene glycol, denatured alcohol) Args: query: Product, brand or type, e.g. "cerave foaming cleanser". country: Market — "se" (Sweden), "no" (Norway), "dk" (Denmark), "fi" (Finland). More markets may be added over time — get_service_info returns the current list. category: Optional filter: skincare, makeup, haircare, fragrance, nails, body, accessories. max_price: Optional max price in the market's local currency. key_ingredient: Ingredient-group slug(s) the product must contain. Comma-separated = OR (contains any of them). E.g. "retinol", "retinol,niacinamide". Call list_key_ingredients for all 67 slugs. exclude_ingredient: Ingredient-group slug(s) the product must NOT contain (excludes products with any of them). E.g. "fragrance", "sls,silicones". Use for targeted free-from requests. exclude_controversial: Shortcut — exclude ALL commonly-avoided ingredients at once (the full list above). attribute: Brand-level ethics/values filter. Slugs: "vegansk" (vegan), "djurtestfri" (cruelty-free), "ekologisk" (organic/natural), "skonsam" (gentle/free-from), "hallbar" (sustainable). Comma-separated = AND (brand must have ALL). Matches brands with either a third-party certification OR the brand's own claim in that bucket — check get_product_details for the verified/claimed distinction before presenting as fact. limit: Max results (1-20).