List MasterKala blog posts (buying guides, comparisons, how-tos), newest first, with links.

Use when the user asks which product type to choose or how to use a gadget: point them to the matching guide. Readers' questions answered by the store: mk_blog_comments.

Read the comments of a blog post as threads, with the store writer's answers as replies.

Useful as a support FAQ: many posts hold readers' product questions answered by MasterKala.

Search MasterKala products by keyword: price, discount and stock of each match.

Use first for "price of X" / "do you have X". In-stock items come first. Also returns matching categories (ids for mk_browse) and brand/tag pages. For the cheapest in-stock match use mk_find_cheapest; to sort or filter a category use mk_browse; full details of one product: mk_product.

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

Use when the user wants the lowest price for X. Scans the search results, keeps items that can be bought online now, and sorts by final_price (after discount, Toman). Most items ship free when the basket reaches 5,000,000 Toman (free_shipping); bulky ones never do. mk_shipping gives the exact fee and date. complete=false means in-stock items go on past scanned: raise scan.

List the products of a category, brand or tag with sorting, price range and filters.

Use for "cheapest Bluetooth earbuds", "Xiaomi power banks between 1 and 2 million Toman", "newest smart watches". Pass exactly one of category_id / brand / tag_id. Get category ids from mk_categories or mk_search, brand slugs from mk_brands, and filter ids (brand, color, attribute) plus the price range from mk_filters. For a keyword use mk_search or mk_find_cheapest (the site ignores sorting on keyword listings). There is no rating sort: check candidates with mk_reviews. Details: mk_product.

List the filters of a category, brand or tag page (brands, colors, attributes) with their ids, and its price range.

Use before mk_browse when the user wants a brand, color or feature inside a category: each group's options map filter id -> name; pass the ids as filter_ids. Long groups other than brands are cut to 40 options (omitted says how many more); ask for that group to see all. max_price is the most expensive item in the listing (Toman).

List MasterKala's product categories with their ids (about 100 main categories).

Use to get a category_id for mk_browse / mk_filters. mk_search also returns the categories matching a keyword.

List the brands MasterKala sells with their slugs (about 135).

Use to get the brand slug for mk_browse / mk_filters ('anker-fa', 'mcdodo').

List every product on MasterKala's discount page right now, biggest discount first.

Use for "what's on sale" / "best discounts today". ends_in_seconds is the time left in the current offer period. Discounts inside one keyword or category: mk_search / mk_browse.

Get one product's full record: price and discount (Toman), stock status and count, colors and which are buyable, brand, category path, rating, and the physical branches that have it.

Use after mk_search / mk_browse when the user picks a product. Specs table: mk_specs. Reviews: mk_reviews. Delivery date and fee: mk_shipping.

Get the specification table of 1-4 products side by side, with each product's stock count.

Use for "battery life / Bluetooth version of X" or to compare products row by row. Each spec row has one value per product id; a missing id means no value for that product. Ids that do not exist are listed in not_found.

Read customer reviews of a product (1-5 stars, newest first) with the store's replies and the star breakdown.

Use as a quality check before recommending a product. average and star_counts cover all reviews; count is the number matching stars.

Get the nearest delivery slot and shipping fee for one product: Tehran courier and post to other cities.

Use for "when will it arrive / how much is shipping". Fees are Toman, 0 = free. Shipping is free when the basket reaches free_shipping_from; null means this item never ships free (bulky goods). same_day_seconds_left > 0 means an order placed now can still arrive today in Tehran. Estimates use a default Tehran address.

List MasterKala's physical shops in Tehran with address, phone and map location.

Use when the user wants to buy in person. mk_product's branches says which shops have a given product; call the shop before going, they stock only part of the catalog.