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 their filter codes: pass one back as category_code (e.g. phones, not phone cases) or brand_codes to narrow the search. For the cheapest offers over several pages use tl_find_cheapest; for one product's sellers, colors and installment prices use tl_product.

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

Use when the user wants the lowest price. Cheap accessories (cases, glass) and other models often match a model name ('آیفون 16' also matches Galaxy A16): check the returned categories and brands, call again with category_code and brand_codes, and check titles. Prices are the site's featured offer per product (not always the cheapest seller); tl_product shows every seller, color 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 to list all the brand's products. Empty list: the site spells the brand differently (هوآوی, not هواوی); call tl_search with the name and take the code from its brands facet.

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 (laptops, phones) or brand sorted by price or popularity, with filters. Get brand and attribute codes (RAM, screen size, CPU...) 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 filter by brand (brand_codes), by category on brand and promotion pages (category_codes) or by attributes such as RAM, screen size, CPU series or usage (attribute_codes).

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

Use for questions about physical stores, how and how much shipping costs per city, returns and how to pay. Exact shipping cost of an order needs a logged-in address, so quote the rules from here. For other questions try tl_faq.

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

Use for policy questions (installments, delivery, returns, warranty, invoices). Short 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 tell which city an address is in (shipping methods depend on the city, see tl_store_info topic=shipping) or to find the nearest branch.

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

Use to confirm a delivery point with the user, or to 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 when the discount stops (UTC). total is the size of 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 of them; more_on_page counts the matches cut off (raise limit to see them). For discounts inside 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) linked 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 of its products with filters (products_in_carousel counts only the carousel, not the page).

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 to answer "where is it cheapest, which color, which warranty, when does it ship, how much in installments". 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; specs no product fills are left out. Products of the same category compare best. For sellers and colors of one product 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 a product. sort=lowest_rated surfaces complaints. The AI summary (null for products with few reviews) comes on page 0 only. The rating sorts rank the newest 500 reviews, newest first within a rating.

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

Prices on Technolife's server as a guest; nothing is saved, no login, no order. Shipping is not included (it needs a logged-in address). max_count is the most units one order may contain; over_max_count means the site will refuse that quantity. Each seller_item_id may appear once: compare cash and installment in separate calls.