Digikala

Rank the best-rated in-stock products within a budget (Toman) by a rating weighted by its count. A 5.0 from 3 buyers does not beat a 4.6 from 900; ties go to the cheaper one. A query keeps only titles with every word and drops accessories. Use for "best X under Y"; then dk_product, dk_reviews.

List current best sellers, overall or in one main category; also returns the main categories' ids for category_id.

List a brand's products with sort and price filters (Toman), plus the brand id for brand_ids. For one brand inside one category use dk_category_products(brand_code=...).

Find category codes for dk_category_products and main-category ids for dk_best_sellers. query matches the Persian name or English code (Persian finds more: 'لپ تاپ' finds the laptop leaf, 'laptop' does not); parent_id lists children; neither lists the main categories. A category with subcategories mixes in accessories: browse its product leaf.

List one category's products with sort and filters (price in Toman), strict order. E.g. "cheapest laptops" (category 'notebook-netbook-ultrabook'), "best-selling Xiaomi phones" (brand_code='xiaomi'). Feature ids come from dk_filters(category_code=...). No text query here.

Compare 2-4 products side by side: price and rating, then the spec rows where they differ. `values` in a `specs` row follow the order of `products` (null = no such spec); identical rows fold into `same_specs`. Best within one category. Unknown ids are listed in `missing_ids`.

List today's Incredible Offers (flash deals), biggest discount first, in-stock only. Each product has discount_pct, price_before_discount and deal_ends (Tehran time). store='supermarket' lists Fresh deals.

List the filters of a category or a search: attributes, colors, sellers, price range (Toman), brands. Attributes give {value title: id}; one with over 15 values only has `value_count`: call again with attribute_id. Colors are {title: id}; brands {code: id} (category only); categories {code: title} (query only). Pass the ids to dk_category_products or dk_search (attributes={attribute id: [value ids]}, colors, seller_type, brand_ids).

Find the cheapest in-stock products that really match a query, sorted by price (Toman). Scans the top relevant results, keeps titles with every query word (else any word, with a `note`) and drops accessories. Use for "cheapest X"; then dk_product on the winner, as another seller may sell it for less.

Search or browse Digikala Fresh (supermarket). category_code beats query and also returns sub-categories. For grocery discounts use dk_deals(store='supermarket').

Get the live 18k gold price per gram and gold coin prices, in Toman. gold18_day_change_pct is vs the previous daily point; period change, low and high cover the ~3-month chart. Coins' change_pct is as Digikala shows it. Coins with price null are not for sale.

Get the Digipay credit-line offers for a product, in Toman. A plan is a fixed credit line (credit_amount) repaid in `months` installments of monthly_repayment; it is not sized to the product price, so never present it as "this product for X a month". Needs Digipay approval. An unknown id gives no plans; check it with dk_product.

Turn an address into coordinates, or coordinates into an address with Digikala's city_id and state_id. Pass address + city, or lat + long. Prices are the same everywhere; location only affects delivery.

List Digikala Plus plans (free shipments per month: jet = same-day Tehran/Karaj, fresh = supermarket) with price in Toman and benefits.

Get ~30 days of daily buy-box prices (Toman) per color/variant, with lowest and highest. For "is this a good price?": `lowest_2_days` is the lowest price held two days in a row (`lowest` can be a one-day dip). Days are Jalali. An unknown id gives no variants; check it with dk_product.

Get one product's price, stock, rating, specs and every seller's offer (cheapest first). An offer is one color/size from one seller: price (Toman), stock_left (only when low), warranty, seller rating 0-5, ships_by ('digikala', 'jet' = same-day Tehran/Karaj, 'seller'), free_shipping. lowest_price_30d can be a one-day dip of one color; dk_price_history's lowest_2_days is steadier. Groceries have store='supermarket' and a price that can differ from dk_search's.

Read customers' questions (20 per page) with up to 2 answers each (answered_by: buyer, seller, ...). Texts are cut to 300 characters (full_text=true: whole). Use for practical doubts (compatibility, size, registration).

Read customer reviews: stars 1-5 (null = none), text, pros/cons, verified buyer flag. The overall rating (0-5) is in dk_product. Texts are cut to 300 characters, pros/cons to 5 of 80; full_text=true returns them whole. An unknown id gives no reviews; check it with dk_product.

Search products by name: price (Toman), discount, seller, rating, 20 per page. Search also returns loosely related items: each product has `match` ('all', 'some' with `missing_words`, or 'none'); prefer 'all'. Filter ids come from dk_filters(query=...). sort=cheapest puts accessories first: use dk_find_cheapest for the cheapest real match. Next: dk_product for every seller's offer.

Get a seller's reputation (rating 0-5, on-time shipping, cancellations, returns) and products. Use before recommending an unknown seller. Percentages are the share of good orders (100 = never late).

Re-price up to 10 products in one call: price, cheapest offer, stock, rating and 30-day low (Toman). Use to refresh a watched list or check stock. `cheapest_offer` can be below `price` (the featured offer). `low_30d` is the lowest price held two days in a row, `vs_30d_low_pct` today's price above it (0 = at the low); `lowest_one_day_30d` is Digikala's figure, possibly a one-day dip. For specs use dk_compare; for the daily curve dk_price_history.

List products similar to one (same kind, other models and brands). sort='cheapest' gives cheaper alternatives; then dk_compare.

Autocomplete a vague or misspelled query into keywords, categories and brands. Next: dk_search with a keyword, or dk_category_products with a category code.