digikala.com APIdigikala.com ↗
Access Digikala product data via 3 endpoints: search by keyword, filter by brand/category, get full product details, and pull incredible-offer deals.
curl -X POST 'https://api.parse.bot/scraper/9ae5f9ae-71ec-44e3-990b-b43dab33c609/get_incredible_offers' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"page": 1,
"max_pages": 1
}'Extract all products from the incredible-offers (شگفتانگیز) section including running-out deals and daily discounted products with pagination support.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results |
| max_pages | integer | Maximum number of pages to fetch |
{
"type": "object",
"fields": {
"page": "integer",
"products": "array of product objects with id, title_fa, title_en, url, status, image_url, rating, price (selling_price, rrp_price, discount_percent, is_incredible, sold_percentage), seller, warranty, offer_type",
"total_products": "integer"
},
"sample": {
"data": {
"page": 1,
"products": [
{
"id": 4358098,
"url": "/product/dkp-4358098/پوشینه-شورتی-بزرگسال-ایزی-لایف-سایز-بزرگ-بسته-10عددی",
"price": {
"rrp_price": 6410000,
"is_promotion": false,
"is_incredible": true,
"selling_price": 5641000,
"sold_percentage": 82,
"discount_percent": 12
},
"rating": {
"rate": 90.13,
"count": 6930
},
"seller": {
"id": 1,
"code": "5A52N",
"title": "دیجیکالا"
},
"status": "marketable",
"title_en": "",
"title_fa": "پوشینه شورتی بزرگسال ایزی لایف سایز بزرگ بسته 10عددی",
"warranty": "گارانتی اصالت و سلامت فیزیکی کالا",
"image_url": "https://dkstatics-public.digikala.com/digikala-products/d3d8a31855b4deab2ca98c6432d45e7ff24c01e0_1721819832.jpg?x-oss-process=image/resize,m_lfit,h_300,w_300/format,webp/quality,q_80",
"offer_type": "running_out",
"product_type": "product"
},
{
"id": 21372529,
"url": "/product/dkp-21372529/سکه-گرمی-طلا-18-عیار-زردیس-مدل-zrd-025",
"price": {
"rrp_price": 62690000,
"is_promotion": false,
"is_incredible": true,
"selling_price": 54540000,
"sold_percentage": 70,
"discount_percent": 13
},
"rating": {
"rate": 90,
"count": 2
},
"seller": {
"id": 1,
"code": "5A52N",
"title": "دیجیکالا"
},
"status": "marketable",
"title_en": "",
"title_fa": "سکه گرمی طلا 18 عیار زردیس مدل zrd-0.25",
"warranty": "گارانتی اصالت و سلامت فیزیکی کالا",
"image_url": "https://dkstatics-public.digikala.com/digikala-products/fc51fc81335670ad373a8647fad70d4a5d3e336b_1770035546.jpg?x-oss-process=image/resize,m_lfit,h_300,w_300/format,webp/quality,q_80",
"offer_type": "running_out",
"product_type": "product"
},
{
"id": 17081684,
"url": "/product/dkp-17081684/کرم-ضد-آفتاب-بدون-رنگ-آرت-وینا-spf-50-مدل-highly-effective-محافظ-uva-uvb-و-pa-ضد-حساسیت-ضد-چروک-و-ضد-پیری-مناسب-انواع-پوست-حجم-50-میلیلیتر",
"price": {
"rrp_price": 12537000,
"is_promotion": false,
"is_incredible": true,
"selling_price": 4477000,
"sold_percentage": 60,
"discount_percent": 64
},
"rating": {
"rate": 80.54,
"count": 2395
},
"seller": {
"id": 627137,
"code": "D6D3F",
"title": "شوک ارزونی"
},
"status": "marketable",
"title_en": "",
"title_fa": "کرم ضد آفتاب بدون رنگ آرت وینا SPF 50 مدل Highly Effective محافظ UVA ،UVB و PA+++، ضد حساسیت، ضد چروک و ضد پیری مناسب انواع پوست حجم 50 میلیلیتر",
"warranty": "گارانتی اصالت و سلامت فیزیکی کالا",
"image_url": "https://dkstatics-public.digikala.com/digikala-products/9f4dfb20b270abafa08e5b38e25909d509bcdaf7_1754237193.jpg?x-oss-process=image/resize,m_lfit,h_300,w_300/format,webp/quality,q_80",
"offer_type": "running_out",
"product_type": "product"
}
],
"total_products": 34
},
"status": "success"
}
}About the digikala.com API
The Digikala API gives developers structured access to Iran's largest e-commerce platform across 3 endpoints. Use get_incredible_offers to pull the daily شگفتانگیز (incredible-offers) deals section with pagination, search_products to query the catalog by keyword with sort, category, and brand filters, and get_product_detail to retrieve complete product data including pricing, variants, images, videos, seller info, and specifications.
Endpoints and What They Return
The search_products endpoint accepts a required query string (e.g., 'iphone 16', 'laptop') plus optional parameters: page for pagination, sort for ordering results (1=bestselling, 4=cheapest, 7=newest, 20=most visited), category for category filtering (e.g., 'mobile-phone', 'laptop'), and brand_id to restrict results to a specific brand (e.g., '10' for Apple, '2' for Samsung). The response returns total_items, total_pages, and an array of product objects.
Product Detail
get_product_detail takes a numeric product_id (found in product URLs as dkp-{id}) and returns a full data object: brand (with id, title_fa, title_en, code), colors, images, videos, rating (rate and count), status (marketable or not_marketable), category, seo metadata, and the canonical url. This is the endpoint to use when you need complete specs and variant data for a known product.
Incredible-Offers Section
get_incredible_offers extracts the time-limited deals prominently featured on Digikala's homepage. It supports page and max_pages inputs for paginated retrieval and returns a products array alongside total_products. Each product object includes id, title_fa, title_en, url, status, image_url, rating, and price fields covering selling_price, rrp_price, and discount_percent. This makes it straightforward to monitor running-out deals and discount depths without constructing individual product queries.
- Track daily discount percentages and selling prices in the incredible-offers section for deal aggregator apps.
- Build a price comparison tool by searching a keyword and sorting results by cheapest (
sort=4). - Monitor a brand's full catalog on Digikala by filtering
search_productswith a specificbrand_id. - Populate a product database with Persian and English titles, images, and specs using
get_product_detail. - Detect when a product's
statuschanges frommarketabletonot_marketablefor inventory alerting. - Pull
rating.rateandrating.countacross search results to surface top-rated products in a category. - Extract SEO metadata (
seo.title,seo.description) and canonical URLs for product content pipelines.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Digikala have an official public developer API?+
What price fields does the incredible-offers endpoint return, and does it include historical pricing?+
get_incredible_offers returns current selling_price, rrp_price (recommended retail price), and discount_percent for each deal product. Historical pricing or price-trend data is not included in the response. The API covers current snapshot pricing only. You can fork it on Parse and revise it to add a price-history tracking layer by storing successive snapshots.Can I retrieve customer reviews and written comments for a product?+
get_product_detail returns rating score and count but does not include individual review text or comment threads. The API covers product specs, images, videos, pricing, variants, and seller info. You can fork it on Parse and revise it to add a reviews endpoint that fetches per-product comment data.How does pagination work across the three endpoints?+
search_products returns total_pages and total_items so you can iterate pages using the page input. get_incredible_offers accepts both page and max_pages inputs, letting you cap how many pages are fetched in a single call. get_product_detail operates on a single product ID and does not paginate.Does the search endpoint return seller-level data or only product-level data?+
search_products response returns product-level objects. Seller information — including seller name, rating, and fulfillment details — is only available in the get_product_detail response. If you need seller data for products surfaced via search, you would follow up with get_product_detail using the returned product IDs.