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.

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.

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.

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.

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 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.

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=...).

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).

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 current best sellers, overall or in one main category; also returns the main categories' ids for category_id.

Search or browse Digikala Fresh (supermarket). category_code beats query and also returns sub-categories.

For grocery discounts use dk_deals(store='supermarket').

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.

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.

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.

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).

List products similar to one (same kind, other models and brands).

sort='cheapest' gives cheaper alternatives; then dk_compare.

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.

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.

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.

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

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.

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.