Turn a product name into Technolife product codes (typeahead, up to 30 products, no prices).

Use to resolve a name like 'آیفون 16' to codes for tl_product / tl_compare / tl_reviews. For prices, filters and paging use tl_search.

Search Technolife products with prices, discount, stock and rating.

Also returns the top matching categories and brands with filter codes: pass one back as category_code (phones, not cases) or brand_codes to narrow. For the cheapest over several pages use tl_find_cheapest; for one product's sellers and prices use tl_product.

Find the cheapest in-stock products for a search, one flat list sorted by the real price after discount.

Use for the lowest price. Accessories and other models often match a model name: check the returned categories and brands, call again with category_code and brand_codes, and check titles. Prices are the site's featured offer, not always the cheapest seller: confirm with tl_product, which lists every seller and installment price.

Look up a brand by its Persian name: filter code and brand page.

Pass brand_code in brand_codes of tl_search / tl_find_cheapest / tl_category_products, or brand_page as the url of tl_category_products. Empty list: the site spells the brand differently (هوآوی, not هواوی); take the code from the brands facet of tl_search.

Find category pages and their urls for tl_category_products.

• With query: categories anywhere in the menu whose name matches (best way to get a url).

• With url: that category's sub-pages (brand and series pages).

• With neither: the top-level categories and the titles of their children (get a child's url with query).

List the products of a category, brand or promotion page with prices, discount, stock and rating.

Use to browse a product type or brand by price or popularity. Get brand and attribute codes and the price range from tl_category_filters first. For free text use tl_search.

List the filters of a category, brand or promotion page: brands, categories, price range and attributes with their codes.

Use before tl_category_products to get brand_codes, category_codes (brand and promotion pages) and attribute_codes (RAM, screen size, CPU...).

Read one of Technolife's info pages as plain text.

Use for stores, shipping rules per city, returns and payment. Exact shipping cost needs a logged-in address, so quote the rules. For other questions try tl_faq.

Search Technolife's help-center FAQ and return matching questions with plain-text answers.

Use for policy questions. Single words match best; an empty list means try another word or tl_store_info.

Read customer reviews of the Technolife shop itself (service, delivery), newest first, rating 1-5, with staff replies.

Use to judge the shop rather than a product (for a product use tl_reviews). Dates are Jalali; the newest reviews on the site may be a few years old.

Turn an address or landmark into coordinates with its province and city.

Use to find an address's city (shipping depends on it, see tl_store_info topic=shipping) or the nearest branch.

Describe coordinates as an address with province, city and neighbourhood.

Use to confirm a delivery point or get the city for shipping rules.

List current in-stock discounts (Technolife's main deal list, تکنوآف) and, on page 0, the timed home-page deals (تکنو تایم).

Use for "best deals right now". deal_ends is UTC. total is the whole deal list, before min_discount_pct. With biggest_percent or min_discount_pct each page scans the next 100 deals and returns the best limit; more_on_page counts matches cut off (raise limit). For one category use tl_category_products with sort=biggest_discount_toman.

List current campaigns, or show one campaign's sections and products.

• Without code: campaign landings (code) and promotion pages (page_url) from the home page.

• With code: the campaign's carousels with a few products each, and its links. Pass a page_url to tl_category_products to list all its products (products_in_carousel counts only the carousel).

Get a marketplace seller's reputation (rating 0-5, on-time %, fault-free %, time on Technolife) and its products.

Use to judge a seller found in tl_product offers before recommending its offer.

Get one product's offers: price per color, seller and warranty, stock, delivery time, insurance and installment prices.

Use after tl_search / tl_suggest. offers are cheapest cash price first; installment_price and bnpl_price are the same seller item in the installment (LOAN) and buy now pay later (BNPL) price lists, null if not offered. Pass seller_item_id to tl_price_basket for a final total.

Compare 2-5 products side by side: price, stock, rating and every spec.

specs is {section: {spec: values}} with one value per product, in the order of products; empty specs are left out. Same-category products compare best. For sellers and colors use tl_product.

Read customer reviews of a product: average 0-5, star distribution, AI summary with pros/cons, and the reviews.

Use as a quality check before recommending; sort=lowest_rated surfaces complaints. Review text is cut at 400 characters unless full_text=true. The AI summary (null for few reviews) comes on page 0 only. The rating sorts rank the newest 500 reviews.

Get the exact total for a set of seller items: discounts, insurance, quantity limits, cash vs installment price.

Priced as a guest; nothing is saved. max_count is the most units one order may contain; over_max_count means the site refuses that quantity. Each seller_item_id may appear once: compare cash and installment in separate calls.