Mahally Scraper Saudi Arabia (2026) Real-Time API

Extract products, stores, and reviews from Mahally - Saudi Arabia's largest e-commerce marketplace aggregator with 10M+ products across 50,000+ stores.

Search by keyword, browse categories, filter by city with geo-radius, and extract complete product data. No account or login required.

Seller WhatsApp Extraction

Every product includes the seller's WhatsApp number when available. Use fetchDetails: true to get direct contact info for lead generation, supplier outreach, or sales prospecting.

{
  "whatsapp_mobile": "966557101111",
  "store": {
    "whatsapp_mobile": "966557101111"
  }
}

City Filtering

Filter by any city name in Arabic. Works with all cities available on Mahally.

{
  "city": "الرياض"
}

Radius Search

Add radiusKm for geo-based filtering around ~50 major cities with GPS coordinates: Riyadh (الرياض), Jeddah (جدة), Mecca (مكة المكرمة), Medina (المدينة المنورة), Dammam (الدمام), Taif (الطائف), Tabuk (تبوك), and more.

{
  "city": "جدة",
  "radiusKm": 30
}

If a city doesn't support radius search, the scraper falls back to exact city name matching.

What's Included

Products: Name, price, discount, rating, stock quantity, sold count, images, SKU, description, brand, category hierarchy, payment options, coordinates.

Stores: Name, rating, review count, badges (verified-store, high-orders, etc.), WhatsApp number, charity status.

Reviews: Rating, text content, customer name, date, product info, images.

Quick Start

Search for iPhones (ايفون)

{
  "query": "ايفون",
  "maxProducts": 100
}

Browse Electronics (إلكترونيات وأجهزة)

{
  "category": "إلكترونيات وأجهزة"
}

Products Near Riyadh (الرياض)

{
  "city": "الرياض",
  "radiusKm": 50,
  "maxProducts": 500
}

Discounted Electronics in Jeddah (جدة)

{
  "city": "جدة",
  "category": "إلكترونيات وأجهزة",
  "hasDiscount": true,
  "sortBy": "discount_high"
}

Smart Watches (ساعة ذكية) with Reviews

{
  "query": "ساعة ذكية",
  "fetchDetails": true,
  "fetchStore": true,
  "fetchReviews": true,
  "maxReviewsPerStore": 50,
  "minRating": 4,
  "maxProducts": 200
}

Input Parameters

Parameter	Type	Default	Description
query	String	-	Search query in Arabic or English. Arabic returns more results (e.g., "ايفون" → 143K vs "iphone" → 74K)
category	String	-	Category path in Arabic (use > for subcategories)
city	String	-	City name in Arabic - any city works (e.g., "الرياض" for Riyadh)
radiusKm	Integer	-	Radius in km (1-500) - only works with ~50 major cities
priceMin	Number	-	Minimum price in SAR
priceMax	Number	-	Maximum price in SAR
minRating	Number	-	Minimum rating (1-5)
brand	String	-	Brand name filter
hasDiscount	Boolean	false	Only discounted products
madeInKSA	Boolean	false	Only Saudi-made products
productType	String	-	Filter by type (see options below)
sortBy	String	relevance	Sort order (see options below)
fetchDetails	Boolean	true	Fetch full product details (+$0.0015/product)
fetchStore	Boolean	true	Fetch store info (+$0.0015/store)
fetchReviews	Boolean	true	Fetch reviews (+$0.0008/page)
maxReviewsPerStore	Integer	100	Max reviews per store (1-1000)
maxProducts	Integer	-	Limit results (empty = all)

Product Types

Value	Description	Count
product	Physical products (require shipping)	9M
service	Services	1.2M
digital	Digital products	350K
codes	Digital codes/vouchers	200K
food	Food items	155K
group_products	Product bundles	71K

Sort Options

Value	Description
relevance	Most relevant (default)
newest	Newest first
rating	Best rated
top_selling	Top sellers
price_high	Price: high to low
price_low	Price: low to high
discount_high	Biggest discount
discount_low	Smallest discount
updated	Recently updated

Output

Output Example

{
  "id": 122275859,
  "store_id": 1323374760,
  "public_product_id": "966122275859",
  "name": "ايفون 17 برو ماكس",
  "subtitle": "يدعم ESIM فقط",
  "description_short": "يجب قراءة الصفحة التالية قبل الطلب مهم قبل الطلب",
  "promotion_title": "يجب قراءة الصفحة التالية قبل الطلب مهم قبل الطلب",
  "type": "service",
  "status": "sale",
  "url": "https://mahally.com/products/1323374760/122275859/",
  "image": "https://cdn.salla.sa/qyaGZ/7ba1ac91-60db-47ea-9f4d-6849717372a8-500x500-xwODhymMXt5I0I7m7ObddVh6ERlm1isG6iYDQ86Y.jpg",
  "images": [
    "https://cdn.salla.sa/qyaGZ/fad3e889-6748-46b4-8113-cd1a3bd46941-1000x1000-xwODhymMXt5I0I7m7ObddVh6ERlm1isG6iYDQ86Y.jpg",
    "https://cdn.salla.sa/qyaGZ/2da3ab40-fc22-4814-aef1-5a10ee8383d6-1000x1000-D8H2dYbDyTF7bAE2Oic8uXvSEeAIVGuk0Y6iAjwy.jpg",
    "https://cdn.salla.sa/qyaGZ/8aee098b-ccac-427f-9eda-068ccf6828e3-1000x1000-QahL2ikCxxnt7oS8jRlQIujFePLQnoUhuuHdjBRf.jpg",
    "https://cdn.salla.sa/qyaGZ/e6fe97be-79d0-4fc8-b217-3902c3781981-1000x1000-IGc3aY89zCqb85u2AvdXxze3QR5nbOCY2YElRm1S.jpg",
    "https://cdn.salla.sa/qyaGZ/4d11f096-9e3d-4330-b140-b75003d74e17-1000x1000-soMnApT6RYDOZhf5C5bE3UaWMlKmilETkXkKS96Q.jpg",
    "https://cdn.salla.sa/qyaGZ/da7deafe-b207-41b5-98c6-400b6ce7899b-1000x1000-D2xcrd7VqufA5oq38HOB4l3yMybyTIJC322wShOM.jpg"
  ],
  "images_count": 4,
  "price": 5195,
  "regular_price": 5195,
  "sale_price": 5195,
  "has_discount": false,
  "discount_percentage": 0,
  "sale_end_timestamp": 0,
  "rating": 5,
  "rating_count": 2,
  "all_rating_average": 5.0,
  "all_rating_count": 4,
  "last_rating_timestamp": 1765736030,
  "category_lvl0": "إلكترونيات وأجهزة",
  "category_lvl1": "إلكترونيات وأجهزة > الهواتف الذكية ومسلتزماتها",
  "category_lvl2": "إلكترونيات وأجهزة > الهواتف الذكية ومسلتزماتها > جوالات ابل",
  "salla_category": "آيفون - iPhone",
  "city": "المجمعة",
  "city_en": "Al Majmaah",
  "city_id": 537731218,
  "latitude": 25.64757551787138,
  "longitude": 45.55453577519012,
  "brand": "Apple",
  "has_options": true,
  "requires_shipping": true,
  "made_in_ksa": false,
  "has_qna": 1,
  "is_rising": 0,
  "calories": 0,
  "tags": [
    "ايفون",
    "ايفون ١٦",
    "ايباد اير",
    "ايباد اير",
    "قلم الايباد",
    "قلم الايباد",
    "ابل",
    "ابل",
    "امازون الامريكي",
    "امازون الامريكي"
  ],
  "payment_options": [
    "mada",
    "credit_card",
    "apple_pay",
    "google_pay",
    "tabby_installment"
  ],
  "visible_on": [
    "IOS",
    "ANDROID",
    "WEB"
  ],
  "created_at_timestamp": 1649462400,
  "updated_at_timestamp": 1758585600,
  "scraped_at": "2026-02-04T09:15:19.188304+00:00",
  "scraped_at_timestamp": 1770196519,
  "sku": "",
  "is_available": true,
  "sold_quantity": 74,
  "sold_quantity_desc": "٧٤ مرة",
  "description": "<p><br></p><p class=\"ql-align-right text-right\"><strong style=\"color: rgb(0, 0, 0);\">يجب قراءة الصفحة التالية قبل الطلب</strong><strong style=\"color: rgb(255, 0, 0);\"> </strong><a href=\"https://afyaa-sa.com/مهم-قبل-الطلب/page-394091354\" target=\"_blank\" style=\"color: rgb(255, 0, 0);\"><strong>مهم قبل الطلب</strong></a></p>",
  "product_url": "https://afyaa-sa.com/PWwNWV",
  "short_link_code": "PWwNWV",
  "customer_url": "https://afyaa-sa.com/PWwNWV",
  "thumbnail": "https://cdn.salla.sa/qyaGZ/7ba1ac91-60db-47ea-9f4d-6849717372a8-500x500-xwODhymMXt5I0I7m7ObddVh6ERlm1isG6iYDQ86Y.jpg",
  "main_image": "https://cdn.salla.sa/qyaGZ/7ba1ac91-60db-47ea-9f4d-6849717372a8-500x500-xwODhymMXt5I0I7m7ObddVh6ERlm1isG6iYDQ86Y.jpg",
  "taxed_price": 5195,
  "pre_tax_price": 5195,
  "tax_amount": 0,
  "with_tax": false,
  "weight": 1,
  "weight_type": "kg",
  "rating_total_score": 20,
  "max_items_per_user": 0,
  "unlimited_quantity": true,
  "has_size_guide": false,
  "can_add_note": true,
  "can_upload_file": true,
  "can_buy_as_gift": true,
  "quick_buy_enabled": true,
  "has_preorder": false,
  "channels": [
    "web",
    "mahly"
  ],
  "options": [
    {
      "id": 117117398,
      "product_id": 122275859,
      "name": "القيقا:",
      "description": null,
      "type": "radio",
      "required": true,
      "associated_with_order_time": 0,
      "availability_range": false,
      "not_same_day_order": false,
      "availability_duration": null,
      "block_days": 0,
      "choose_date_time": null,
      "from_date_time": null,
      "to_date_time": null,
      "sort": null,
      "advance": true,
      "purpose": "variants",
      "display_type": "text",
      "visibility": "always",
      "translations": {
        "ar": {
          "option_name": "القيقا:",
          "description": null
        }
      },
      "characters_limit": null,
      "original_option_id": null,
      "values": [
        {
          "id": 1095242006,
          "name": "256GB",
          "price": {
            "amount": 0,
            "currency": "SAR"
          },
          "formatted_price": "",
          "formatted_price_without_tax": "",
          "display_value": null,
          "advance": true,
          "option_id": 117117398,
          "image_url": null,
          "hashed_display_value": null,
          "translations": {
            "ar": {
              "option_details_name": "256GB"
            }
          },
          "is_default": false,
          "is_out_of_stock": false
        },
        {
          "id": 320155671,
          "name": "512GB",
          "price": {
            "amount": 0,
            "currency": "SAR"
          },
          "formatted_price": "",
          "formatted_price_without_tax": "",
          "display_value": null,
          "advance": true,
          "option_id": 117117398,
          "image_url": null,
          "hashed_display_value": null,
          "translations": {
            "ar": {
              "option_details_name": "512GB"
            }
          },
          "is_default": false,
          "is_out_of_stock": false
        },
        {
          "id": 1827823376,
          "name": "1TB",
          "price": {
            "amount": 0,
            "currency": "SAR"
          },
          "formatted_price": "",
          "formatted_price_without_tax": "",
          "display_value": null,
          "advance": true,
          "option_id": 117117398,
          "image_url": null,
          "hashed_display_value": null,
          "translations": {
            "ar": {
              "option_details_name": "1TB"
            }
          },
          "is_default": false,
          "is_out_of_stock": false
        },
        {
          "id": 1660923015,
          "name": "2TB",
          "price": {
            "amount": 0,
            "currency": "SAR"
          },
          "formatted_price": "",
          "formatted_price_without_tax": "",
          "display_value": null,
          "advance": true,
          "option_id": 117117398,
          "image_url": null,
          "hashed_display_value": null,
          "translations": {
            "ar": {
              "option_details_name": "2TB"
            }
          },
          "is_default": false,
          "is_out_of_stock": false
        }
      ]
    },
    {
      "id": 1063245807,
      "product_id": 122275859,
      "name": "اللون:",
      "description": "",
      "type": "radio",
      "required": true,
      "associated_with_order_time": 0,
      "availability_range": false,
      "not_same_day_order": false,
      "availability_duration": null,
      "block_days": 0,
      "choose_date_time": null,
      "from_date_time": null,
      "to_date_time": null,
      "sort": 0,
      "advance": false,
      "purpose": "form",
      "display_type": null,
      "visibility": "always",
      "translations": {
        "ar": {
          "option_name": "اللون:",
          "description": ""
        }
      },
      "characters_limit": null,
      "original_option_id": null,
      "values": [
        {
          "id": 1670005583,
          "name": "كحلي",
          "price": {
            "amount": 0,
            "currency": "SAR"
          },
          "formatted_price": "",
          "formatted_price_without_tax": "",
          "display_value": null,
          "advance": false,
          "option_id": 1063245807,
          "image_url": null,
          "hashed_display_value": null,
          "translations": {
            "ar": {
              "option_details_name": "كحلي"
            }
          },
          "is_default": false,
          "is_out_of_stock": false
        },
        {
          "id": 1029136968,
          "name": "برتقالي",
          "price": {
            "amount": 0,
            "currency": "SAR"
          },
          "formatted_price": "",
          "formatted_price_without_tax": "",
          "display_value": null,
          "advance": false,
          "option_id": 1063245807,
          "image_url": null,
          "hashed_display_value": null,
          "translations": {
            "ar": {
              "option_details_name": "برتقالي"
            }
          },
          "is_default": false,
          "is_out_of_stock": false
        },
        {
          "id": 1261277780,
          "name": "فضي",
          "price": {
            "amount": 0,
            "currency": "SAR"
          },
          "formatted_price": "",
          "formatted_price_without_tax": "",
          "display_value": null,
          "advance": false,
          "option_id": 1063245807,
          "image_url": null,
          "hashed_display_value": null,
          "translations": {
            "ar": {
              "option_details_name": "فضي"
            }
          },
          "is_default": false,
          "is_out_of_stock": false
        }
      ]
    }
  ],
  "skus": [
    {
      "id": 547134561,
      "product_id": 122275859,
      "price": {
        "amount": 5195,
        "currency": "SAR"
      },
      "regular_price": {
        "amount": 5195,
        "currency": "SAR"
      },
      "cost_price": {
        "amount": 4800,
        "currency": "SAR"
      },
      "sale_price": null,
      "has_special_price": false,
      "stock_quantity": null,
      "unlimited_quantity": true,
      "notify_low": null,
      "barcode": null,
      "sku": null,
      "mpn": null,
      "gtin": null,
      "updated_at": "2025-09-23 04:40:40",
      "related_options": [
        1095242006
      ],
      "related_option_values": [
        1095242006
      ],
      "weight": null,
      "weight_type": "kg",
      "weight_label": null,
      "is_user_subscribed_to_sku": false,
      "is_default": false,
      "branches_quantities": [
        {
          "id": 904855438,
          "name": "مستودع الزلفي",
          "quantity": null
        }
      ]
    },
    {
      "id": 1920580450,
      "product_id": 122275859,
      "price": {
        "amount": 5995,
        "currency": "SAR"
      },
      "regular_price": {
        "amount": 5995,
        "currency": "SAR"
      },
      "cost_price": {
        "amount": 5550,
        "currency": "SAR"
      },
      "sale_price": null,
      "has_special_price": false,
      "stock_quantity": null,
      "unlimited_quantity": true,
      "notify_low": null,
      "barcode": null,
      "sku": null,
      "mpn": null,
      "gtin": null,
      "updated_at": "2025-09-23 04:40:40",
      "related_options": [
        320155671
      ],
      "related_option_values": [
        320155671
      ],
      "weight": null,
      "weight_type": "kg",
      "weight_label": null,
      "is_user_subscribed_to_sku": false,
      "is_default": false,
      "branches_quantities": [
        {
          "id": 904855438,
          "name": "مستودع الزلفي",
          "quantity": null
        }
      ]
    },
    {
      "id": 1279711843,
      "product_id": 122275859,
      "price": {
        "amount": 6810,
        "currency": "SAR"
      },
      "regular_price": {
        "amount": 6810,
        "currency": "SAR"
      },
      "cost_price": {
        "amount": 6300,
        "currency": "SAR"
      },
      "sale_price": null,
      "has_special_price": false,
      "stock_quantity": null,
      "unlimited_quantity": true,
      "notify_low": null,
      "barcode": null,
      "sku": null,
      "mpn": null,
      "gtin": null,
      "updated_at": "2025-09-23 04:40:40",
      "related_options": [
        1827823376
      ],
      "related_option_values": [
        1827823376
      ],
      "weight": null,
      "weight_type": "kg",
      "weight_label": null,
      "is_user_subscribed_to_sku": false,
      "is_default": false,
      "branches_quantities": [
        {
          "id": 904855438,
          "name": "مستودع الزلفي",
          "quantity": null
        }
      ]
    },
    {
      "id": 1366974086,
      "product_id": 122275859,
      "price": {
        "amount": 8425,
        "currency": "SAR"
      },
      "regular_price": {
        "amount": 8425,
        "currency": "SAR"
      },
      "cost_price": {
        "amount": 0,
        "currency": "SAR"
      },
      "sale_price": null,
      "has_special_price": false,
      "stock_quantity": null,
      "unlimited_quantity": true,
      "notify_low": null,
      "barcode": null,
      "sku": null,
      "mpn": null,
      "gtin": null,
      "updated_at": "2025-09-23 04:40:40",
      "related_options": [
        1660923015
      ],
      "related_option_values": [
        1660923015
      ],
      "weight": null,
      "weight_type": "kg",
      "weight_label": null,
      "is_user_subscribed_to_sku": false,
      "is_default": false,
      "branches_quantities": [
        {
          "id": 904855438,
          "name": "مستودع الزلفي",
          "quantity": null
        }
      ]
    }
  ],
  "likes_count": 1,
  "mahly_category_id": 1451175644,
  "brand_id": 1918225013,
  "brand_logo": "https://cdn.salla.sa/qyaGZ/Cy5KZZAt2guCENVmced2uoVpfd4X0uplKFQLIlbB.png",
  "installment_options": [
    {
      "name": "tabby",
      "title": "قسمها على 4 دفعات شهرية بقيمة 1298.75 ر.س بدون رسوم أو فوائد"
    }
  ],
  "whatsapp_mobile": "966504476452",
  "store": {
    "id": 1323374760,
    "name": "متجر أفياء",
    "username": "afyaa.sa",
    "about": "متخصصون بتوفير منتجات أبل الأصلية من الشركة الأم في أمريكا بسعر منافس مع ضمان الوكيل.",
    "avatar": "https://cdn.salla.sa/qyaGZ/XzvGJZjlMFOOt0dnkTkkcW5ACjasKH7jcdJWJaUg.jpg",
    "domain": "https://afyaa-sa.com",
    "city": "المجمعة",
    "rating": 4.3,
    "rating_count": 55,
    "whatsapp_mobile": "966504476452",
    "main_activity": "الكترونيات",
    "activities": [
      "الكمبيوترات والأجهزة المحمولة وملحقاتها"
    ],
    "tier": 2,
    "badges": [
      "more-than-tree-years",
      "high-orders",
      "has-return-or-exchange-policy",
      "verified-store",
      "has-default-address",
      "has-freelance-certificate"
    ],
    "badges_labels": [
      "منذ 3 سنوات",
      "عالي الطلب",
      "سياسة  استرجاع",
      "موّثق",
      "عنوان رسمي",
      "وثيقة عمل حر"
    ],
    "is_rising": false,
    "is_charity": false,
    "return_policy": "<p><strong>سياسة الاستبدال والاسترجاع:</strong></p><p>جميع المنتجات في هذا المتجر يتم شراؤها بناءً على طلب العميل، وبالنظر إلى سياسة الاستبدال والاسترجاع المعتمدة من قِبل وزارة التجارة فإن أي منتج يتم يتم شراؤه بناء على طلب العميل وحسباً للمواصفات التي يحددها <strong style=\"color: rgb(255, 19, 0);\">لا يمكن إسترجاعه أو استبداله بتاتاً</strong>، باستثناء الحالات التالية:</p><p><br></p><p><strong style=\"color: rgb(255, 0, 0);\">يحق</strong><strong> للمستهلك استبدال او استرجاع المنتج إذا:</strong></p><p>1- كان المنتج يختلف عن المنتج المطلوب.</p><p>2- كان المنتج فيه كسر أو عيب جراء عملية الشحن (غالباً يتم استبدال المنتج بواسطة الضمان)</p><p>3- إذا تم التحقق من الرقم التسلسلي للمنتج في <a href=\"https://checkcoverage.apple.com/\" target=\"_blank\" style=\"color: rgb(89, 202, 234);\">موقع أبل</a> وظهر أنه غير أصلي.</p><p><br></p><p>وفي هذه الحالات يخيّر العميل إما بالتعويض بمبلغ مُرضي أو استبدال المنتج بمنتج جديد، أو استرجاع المنتج واسترداد المبلغ كلياً وذلك بعد معاينة السلعة والتأكد من سبب الضرر.</p><p><br></p><p><strong>وقياساً على ذلك فإنه لا يمكن للعميل إلغاء الطلب إذا كانت حالته \"قيد التنفيذ\" لأن ذلك يعني أنه تم شراء المنتج ولا يمكن إلغاؤه أو استرجاعه لدى موقع الشركة بتاتاً. </strong></p>",
    "reviews": []
  }
}

Pricing

Pay-per-event model - Only pay for what you extract.

Event	Price	Description
item_scraped	$0.0008	Per product in search results
details_scraped	$0.0015	Per product detail fetch
store_scraped	$0.0015	Per unique store
reviews_scraped	$0.0008	Per review page (20 reviews)

Cost Examples

Products	Details	Stores	Reviews	Base	Bronze -10%	Silver -20%	Gold -30%
50	Yes	~10	~50 pages	$0.17	$0.15	$0.14	$0.12
100	Yes	~20	~100 pages	$0.34	$0.31	$0.27	$0.24
250	Yes	~50	~250 pages	$0.85	$0.77	$0.68	$0.60
500	Yes	~100	~500 pages	$1.70	$1.53	$1.36	$1.19
1000	Yes	~200	~1000 pages	$3.40	$3.06	$2.72	$2.38

Assumes ~1 store per 5 products, ~5 review pages per store with all features enabled.

Cost by Feature

Products	Search Only	+ Details	+ Store	+ Reviews (Full)
100	$0.08	$0.23	$0.26	$0.34
500	$0.40	$1.15	$1.30	$1.70
1000	$0.80	$2.30	$2.60	$3.40

Cost Optimization

Set maxProducts to limit results. Disable fetchDetails, fetchStore, or fetchReviews if you only need basic search data.

Categories

Top-level categories with product counts:

Arabic	English	Products
جمال وعناية	Beauty & Care	2.3M
أزياء	Fashion	1.5M
أكل ومشروبات	Food & Drinks	761K
المنزل والحديقة	Home & Garden	508K
إلكترونيات وأجهزة	Electronics	361K

Subcategory Navigation

Use > to drill into subcategories. Example: Fashion > Women's Fashion > Abayas (أزياء > أزياء نسائية > عبايات وطرح)

{
  "category": "أزياء > أزياء نسائية > عبايات وطرح"
}

Cities

Top Saudi cities by product availability:

Arabic	English	Products
الرياض	Riyadh	1.98M
جدة	Jeddah	1.1M
المدينة المنورة	Medina	235K
الدمام	Dammam	182K
مكة المكرمة	Mecca	150K

Integration

Python

from apify_client import ApifyClient

client = ApifyClient("your_api_token")

run_input = {
    "query": "ايفون",
    "city": "الرياض",
    "maxProducts": 100,
    "fetchDetails": True,
    "fetchStore": True
}

run = client.actor("zen-studio/mahally-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['name']} - {item['price']} SAR - {item['city']}")

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'your_api_token' });

const run = await client.actor('zen-studio/mahally-scraper').call({
    query: 'ايفون',
    city: 'الرياض',
    maxProducts: 100,
    fetchDetails: true,
    fetchStore: true
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(item => {
    console.log(`${item.name} - ${item.price} SAR - ${item.city}`);
});

Advanced Examples

Price Monitoring Setup

Track discounted electronics under 500 SAR:

{
  "category": "إلكترونيات وأجهزة",
  "hasDiscount": true,
  "priceMax": 500,
  "sortBy": "discount_high",
  "maxProducts": 500
}

Competitor Store Analysis

Extract all products from top-rated stores:

{
  "category": "جمال وعناية",
  "minRating": 4.5,
  "fetchDetails": true,
  "fetchStore": true,
  "sortBy": "top_selling",
  "maxProducts": 1000
}

Lead Generation

Get seller contacts for a specific brand:

{
  "query": "سامسونج",
  "city": "جدة",
  "fetchDetails": true,
  "fetchStore": true,
  "maxProducts": 200
}

Review Analysis

Collect customer feedback for market research:

{
  "category": "أكل ومشروبات",
  "minRating": 4,
  "fetchReviews": true,
  "maxReviewsPerStore": 100,
  "maxProducts": 100
}

FAQ

Q: Do I need a Mahally account? A: No. The scraper works without any login or authentication.

Q: How many products can I extract? A: All 10M+ products are accessible. Use maxProducts to limit results or leave empty for all matching items.

Q: What's the data freshness? A: Data is extracted in real-time from Mahally's live catalog.

Q: Can I filter by multiple cities? A: Currently one city per run. Run multiple times for different cities, or omit the city filter for all Saudi Arabia.

Q: How does geo-search work? A: Set city and radiusKm together. The scraper finds products within that radius from the city center coordinates.

Q: Are product images included? A: Yes. Each product includes the main image URL and an array of all product images.

Q: How do I get seller contact info? A: Enable fetchDetails: true to get the whatsapp_mobile field for each product/store.

Q: What if a search returns no results? A: Check your Arabic spelling, try broader filters, or remove some filter parameters.

Disclaimer

Data is collected from publicly available sources and provided "as is" for informational purposes. Users are responsible for compliance with Mahally's terms of service and applicable regulations.