search_products
Find products on Digikala by searching within specific categories using keywords, with options to filter by price, discount, colors, and sort results.
Instructions
Search for products within a specific category with filtering and sorting. Returns 20 products per page. CRITICAL WORKFLOW: ALWAYS call get_optimized_keywords_and_categories FIRST to get the category_id for your search - this API requires it. Use the keyword-category pairs from that response. Search with BOTH Persian (Farsi) and English keywords separately - they produce different results, with Farsi often being more comprehensive. All prices in TOOMAN (1 Tooman = 10 Rials).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category_id | Yes | Category ID to search within (REQUIRED - get this from get_optimized_keywords_and_categories) | |
| keyword | Yes | Search keyword string for products, retrieved from the get_optimized_keywords_and_categories tool results | |
| page | No | Page number (starts from 1) | |
| sort | No | Sort order: 1=Relevance, 2=Price Low-High, 3=Price High-Low, 4=Newest, 5=Best Selling, 6=Most Viewed, 7=Highest Rated | |
| price_min_tooman | No | Minimum price in Toomans (e.g., 1000 Toomans = 10,000 Rials) | |
| price_max_tooman | No | Maximum price in Toomans (e.g., 5000 Toomans = 50,000 Rials) | |
| discount_min | No | Minimum discount percentage | |
| discount_max | No | Maximum discount percentage | |
| colors | No | List of color IDs to filter by |