Search products by keyword: price, discount and stock of each match. Also returns the best-matching categories (ids for kh_browse) and brands (slugs).

Use first for "price of X". Next: kh_find_cheapest, kh_filters + kh_browse, kh_product.

Find the cheapest in-stock products for a keyword, one flat list by payable price (Toman).

Use for the lowest price of X. Drops loose matches whose title lacks a query word (match_all_words). Narrow with category_id. complete=false: matches go on past scanned, raise scan. Next: kh_product.

List products of a category, brand(s) or campaign tag with sorting, price range and filters.

Use for "sunscreens for oily skin under 800,000 Toman". Pass at least one of category_id (kh_categories), brands (kh_brands) or tag (kh_deals); filter ids come from kh_filters. No rating or discount sort. Next: kh_product / kh_reviews.

List the filters of a category, brand, tag or search: sub-categories, brands, colors and attribute facets (skin type, hair type, ingredients, ...) with ids and counts, plus price range and stock counts.

Use before kh_browse: pass brand slugs as brands, color ids as colors, facet keys as facets. Brands are cut to 40 and each group to 25 values (omitted = how many more); pass group to see one in full. price_range is on the list price before discount (min 0 = out-of-stock items).

List Khanoumi's category tree with ids, URL paths and product counts.

Use to get a category_id for kh_browse / kh_filters / kh_find_cheapest. A query searches every level; without one only levels up to max_level are listed.

Find brands by name (about 3,200) with their slugs, for the brands of kh_browse / kh_filters.

List today's home-page deals (daily pink box "جعبه صورتی" and other rows), biggest discount first, plus the public discount code of the current pop-up campaign.

Use for "what's on sale". pink_box_ends_in_seconds = time left in the daily box. A section's tag lists all its products via kh_browse(tag=...); a section without a tag has only link. Voucher conditions are in voucher.text.

Get Khanoumi's order rules from the official FAQ: packaging cost, shipping fees and times, returns, payment and refunds, authenticity guarantee, pink-box rules.

Use for "how much is shipping", "can I return it", and the true order cost (formula in the server instructions; the fees are in the delivery answers). With topic=all and no query, answers are cut to 300 characters (end with …); pick a topic or a query, or set full_text=true, for full text.

Search the Khanoumi magazine (مجله خانومی): buying guides, care routines, ingredient explainers, with links.

Use when the user asks what suits them or how to use something; then find products with kh_search.

Get one product's full record: price and discount (Toman), every shade / size / seller variant with its own price, stock and max quantity, rating, brand, categories, attributes and description.

Use after kh_search / kh_browse, or to check that a shade is in stock and its price. Next: kh_reviews, kh_similar, kh_store_info (fees).

Read customer comments on a product, newest first, with a verified-buyer flag and photos.

Use as a quality check before recommending. Text is cut to 400 characters (ends with …) unless full_text=true. No star ratings per comment: the average is in kh_product.

List alternatives to a product (about 20) or the products the shop pairs with it, with prices and stock.

Use when a product is out of stock or too expensive, or to build a routine.