{ "openapi": "3.0.1", "info": { "title": "Haraj Scraper - Saudi Arabia Classifieds (حراج)", "description": "Scrape Haraj (haraj.com.sa), Saudi Arabia's biggest classifieds site: cars, real estate, devices, animals and 1,300 categories. Price in SAR, region, city, district, map point, full text, phone numbers from the ad, car specs, seller and photos. Car filters, no proxy needed.", "version": "1.0", "x-build-id": "5nIuxJzkoAqkRdOT4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~haraj-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-haraj-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/normdata~haraj-scraper/runs": { "post": { "operationId": "runs-sync-normdata-haraj-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/normdata~haraj-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-haraj-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many ads in total. Leave empty for no limit. The Apify Free plan is always capped at 10." }, "categories": { "title": "Categories", "type": "array", "description": "Haraj categories and their first level, like car brands or property types (219; type to search, in English or Arabic).", "items": { "type": "string", "enum": [ "حراج السيارات", "تويوتا", "هونداي", "نيسان", "فورد", "كيا", "شيفروليه", "لكزس", "قطع غيار وملحقات", "شاحنات ومعدات ثقيلة", "دبابات", "مرسيدس", "جي ام سي", "هوندا", "ايسوزو", "بي ام دبليو", "دودج", "مازدا", "شانجان", "ميتسوبيشي", "لاند روفر", "جيتور", "جيلي", "جيب", "MG", "سوزوكي", "هافال", "جنسس", "اودي", "تشيري", "بورش", "كرايزلر", "كاديلاك", "جي ايه سي GAC", "بيجو", "فولكس واجن", "فاو FAW", "لنكولن", "ديهاتسو", "انفنيتي", "جريت وول Great Wall", "BYD", "جاك JAC", "فيات", "دونج فينج", "بنتلي", "تانك", "فوتون", "رولز رويس", "جاكوار", "بايك", "مازيراتي", "همر", "جى ام سي JMC", "فولفو", "ماكسيس", "ساب", "تاتا", "سوبارو", "لامبورجيني", "لوسيد", "بيوك", "هونشي", "جايكو", "سمارت", "سانج يونج", "سكودا", "لينك اند كو", "فيراري", "روكس", "استون مارتن", "سيات", "ليفان", "ZXAUTO", "سيتروين", "ميركوري", "فيكتوري اوتو", "اكسيد", "سي ام سي", "الفا روميو", "تسلا", "ساوايست", "ماهيندرا", "رينو", "ماكلارين", "هانجاي", "زوتي", "امودا", "اوبل", "لوتس", "اينيوس", "دايو", "كايي", "بروتون", "حراج الأجهزة", "جوالات", "أجهزة كمبيوتر", "اجهزة منزليه", "حسابات واشتراكات", "تلفزيونات وصوتيات", "كاميرات تصوير", "أرقام مميزة", "مواطير ومولدات", "ألعاب إلكترونية", "مايكروسوفت Microsoft", "ال جي LG", "باناسونيك Panasonic", "هيتاشي Hitachi", "أجهزة تابلت", "اجهزة غير مصنفة", "حراج العقار", "شقق للايجار", "اراضي للبيع", "استراحات للايجار", "فلل للبيع", "شقق للبيع", "محلات للتقبيل", "غرف للايجار", "عمارة للبيع", "دور للبيع", "محلات للايجار", "فلل للايجار", "ادوار للايجار", "مستودعات للايجار", "بيوت للبيع", "مزارع للبيع", "مكاتب للايجار", "عماره للايجار", "استراحات للبيع", "اراضي تجارية للبيع", "مزرعة للايجار", "بيوت للايجار", "شاليهات للبيع", "مستودع للبيع", "مخيمات للايجار", "كمباوند للبيع", "كمباوند للايجار", "قاعة للايجار", "اثاث", "أدوات منزلية", "مجالس ومفروشات", "طاولات وكراسي", "أسرة ومراتب", "خزائن ودواليب", "أثاث خارجي", "تحف وديكور", "أثاث مكتبي", "خدمات", "خدمات مقاولات", "خدمات التوصيل", "خدمات تعقيب", "خدمات نقل العفش", "خدمات نظافة", "خدمات قانونية", "خدمات محاسبية ومالية", "خدمات الشراء من المواقع العالمية", "خدمات اخرى", "مستلزمات شخصية", "ملابس نسائية", "مستلزمات رياضية", "ملابس رجالية", "عطورات", "ساعات", "الصحة والجمال", "هدايا", "ملابس أطفال", "نظارات", "أمتعة سفر", "مواشي وحيوانات وطيور", "ببغاء", "غنم", "قطط", "دجاج", "ماعز", "أبل", "حمام", "خيل", "كلاب", "أسماك وسلاحف", "ارانب", "بط", "وبر", "بقر", "هامستر", "سناجب", "وظائف", "وظائف اداريه", "وظائف عمالة منزلية", "وظائف مطاعم", "وظائف ازياء وتجميل", "وظائف صناعية", "وظائف تعليمية", "وظائف طب وتمريض", "وظائف عمارة وبناء", "وظائف امن وسلامة", "وظائف تقنية وتصميم", "وظائف زراعة ورعي", "العاب وترفيه", "تعليم وتدريب", "دروس خصوصية", "دورات تدريبية", "تدريب رياضي", "تعليم قيادة", "تدريب العاب الكترونية", "تعليم اسهم وعملات", "اطعمة ومشروبات", "حفلات ومناسبات", "برمجة وتصاميم", "زراعة وحدائق", "نوادر و تراثيات", "مشاريع واستثمارات", "مكتبة وفنون", "صيد ورحلات", "سفر وسياحة", "شاليهات للايجار", "شريك سكن", "شقق مخدومة", "مفقودات", "قسم غير مصنف" ], "enumTitles": [ "Cars (حراج السيارات)", "Cars › Toyota (تويوتا)", "Cars › Hyundai (هونداي)", "Cars › Nissan (نيسان)", "Cars › Ford (فورد)", "Cars › Kia (كيا)", "Cars › Chevrolet (شيفروليه)", "Cars › Lexus (لكزس)", "Cars › Parts & Accessories (قطع غيار وملحقات)", "Cars › Trucks and heavy equipment (شاحنات ومعدات ثقيلة)", "Cars › Motorcycles (دبابات)", "Cars › Mercedes (مرسيدس)", "Cars › GMC (جي ام سي)", "Cars › Honda (هوندا)", "Cars › Isuzu (ايسوزو)", "Cars › BMW (بي ام دبليو)", "Cars › Dodge (دودج)", "Cars › Mazda (مازدا)", "Cars › Changan (شانجان)", "Cars › Mitsubishi (ميتسوبيشي)", "Cars › Land Rover (لاند روفر)", "Cars › JETOUR (جيتور)", "Cars › Geely (جيلي)", "Cars › Jeep (جيب)", "Cars › MG (MG)", "Cars › Suzuki (سوزوكي)", "Cars › Haval (هافال)", "Cars › Genesis (جنسس)", "Cars › Audi (اودي)", "Cars › Chery (تشيري)", "Cars › Porsche (بورش)", "Cars › Chrysler (كرايزلر)", "Cars › Cadillac (كاديلاك)", "Cars › GAC (جي ايه سي GAC)", "Cars › Peugeot (بيجو)", "Cars › Volkswagen (فولكس واجن)", "Cars › FAW (فاو FAW)", "Cars › Lincoln (لنكولن)", "Cars › Daihatsu (ديهاتسو)", "Cars › Infinity (انفنيتي)", "Cars › Great Wall (جريت وول Great Wall)", "Cars › BYD (BYD)", "Cars › JAC (جاك JAC)", "Cars › Fiat (فيات)", "Cars › Dongfeng (دونج فينج)", "Cars › Bentley (بنتلي)", "Cars › Tank (تانك)", "Cars › Foton (فوتون)", "Cars › Rolls-Royce (رولز رويس)", "Cars › Jaguar (جاكوار)", "Cars › Baic (بايك)", "Cars › Maserati (مازيراتي)", "Cars › Hummer (همر)", "Cars › JMC (جى ام سي JMC)", "Cars › Volvo (فولفو)", "Cars › MAXUS (ماكسيس)", "Cars › SABB (ساب)", "Cars › TATA (تاتا)", "Cars › Subaru (سوبارو)", "Cars › Lamborghini (لامبورجيني)", "Cars › Lucid (لوسيد)", "Cars › Buick (بيوك)", "Cars › Hongqi (هونشي)", "Cars › Jaecoo (جايكو)", "Cars › SMART (سمارت)", "Cars › SsangYong (سانج يونج)", "Cars › Skoda (سكودا)", "Cars › Lynk & Co (لينك اند كو)", "Cars › Ferrari (فيراري)", "Cars › ROX (روكس)", "Cars › Aston Martin (استون مارتن)", "Cars › Seat (سيات)", "Cars › Lifan (ليفان)", "Cars › ZXAUTO (ZXAUTO)", "Cars › Citroen (سيتروين)", "Cars › Mercury (ميركوري)", "Cars › VICTORY AUTO (فيكتوري اوتو)", "Cars › EXEED (اكسيد)", "Cars › CMC (سي ام سي)", "Cars › Alfa Romeo (الفا روميو)", "Cars › Tesla (تسلا)", "Cars › Soueaste (ساوايست)", "Cars › Mahindra (ماهيندرا)", "Cars › Renault (رينو)", "Cars › McLaren (ماكلارين)", "Cars › Huanghai (هانجاي)", "Cars › Zotye (زوتي)", "Cars › OMODA (امودا)", "Cars › Opel (اوبل)", "Cars › Lotus (لوتس)", "Cars › INEOS (اينيوس)", "Cars › Daewoo (دايو)", "Cars › KAIYI (كايي)", "Cars › Proton (بروتون)", "Devices (حراج الأجهزة)", "Devices › Phones (جوالات)", "Devices › Computers (أجهزة كمبيوتر)", "Devices › Home & Kitchen Appliances (اجهزة منزليه)", "Devices › Accounts​ and Subscriptions (حسابات واشتراكات)", "Devices › TV & Audio​ (تلفزيونات وصوتيات)", "Devices › Digital Cameras​ (كاميرات تصوير)", "Devices › Special Numbers (أرقام مميزة)", "Devices › Generators (مواطير ومولدات)", "Devices › Gaming​ (ألعاب إلكترونية)", "Devices › Microsoft (مايكروسوفت Microsoft)", "Devices › LG (ال جي LG)", "Devices › Panasonic (باناسونيك Panasonic)", "Devices › Hitachi (هيتاشي Hitachi)", "Devices › Tablets​ (أجهزة تابلت)", "Devices › Uncategorized Devices (اجهزة غير مصنفة)", "Real Estate (حراج العقار)", "Real Estate › Apartments for Rent (شقق للايجار)", "Real Estate › Lands For Sale (اراضي للبيع)", "Real Estate › Chalets for rent (استراحات للايجار)", "Real Estate › Villas for sale (فلل للبيع)", "Real Estate › Apartments for sale (شقق للبيع)", "Real Estate › Shops for waiver (محلات للتقبيل)", "Real Estate › Rooms for rent (غرف للايجار)", "Real Estate › Building for sale (عمارة للبيع)", "Real Estate › Floor Through For Sale (دور للبيع)", "Real Estate › Shops for rent (محلات للايجار)", "Real Estate › Villas for rent (فلل للايجار)", "Real Estate › Floors Through for rent (ادوار للايجار)", "Real Estate › Warehouses for rent (مستودعات للايجار)", "Real Estate › Houses for sale (بيوت للبيع)", "Real Estate › Farms for sale (مزارع للبيع)", "Real Estate › Offices For Rent (مكاتب للايجار)", "Real Estate › Buildings for rent (عماره للايجار)", "Real Estate › Chalets for sale (استراحات للبيع)", "Real Estate › Commercial Land For Sale (اراضي تجارية للبيع)", "Real Estate › Farm for rent (مزرعة للايجار)", "Real Estate › Houses for rent (بيوت للايجار)", "Real Estate › Chalets for sale (شاليهات للبيع)", "Real Estate › Warehouse for sale (مستودع للبيع)", "Real Estate › Camps for rent (مخيمات للايجار)", "Real Estate › Compound for sale (كمباوند للبيع)", "Real Estate › Compound for rent (كمباوند للايجار)", "Real Estate › Hall for rent (قاعة للايجار)", "Furniture (اثاث)", "Furniture › Houseware (أدوات منزلية)", "Furniture › Sofas and furnishings (مجالس ومفروشات)", "Furniture › tables and chairs (طاولات وكراسي)", "Furniture › Beds and mattresses (أسرة ومراتب)", "Furniture › Cabinets and cupboards (خزائن ودواليب)", "Furniture › Outdoor furniture (أثاث خارجي)", "Furniture › Antiques and decor (تحف وديكور)", "Furniture › Office Furniture (أثاث مكتبي)", "Services (خدمات)", "Services › Construction Services (خدمات مقاولات)", "Services › Delivery Services (خدمات التوصيل)", "Services › Agent Services (خدمات تعقيب)", "Services › Furniture Transfering Services (خدمات نقل العفش)", "Services › Cleaning Services (خدمات نظافة)", "Services › legal services (خدمات قانونية)", "Services › Accounting and financial services (خدمات محاسبية ومالية)", "Services › Buying From Foregin Websites Services (خدمات الشراء من المواقع العالمية)", "Services › Other services (خدمات اخرى)", "Fashion (مستلزمات شخصية)", "Fashion › Women's fashion (ملابس نسائية)", "Fashion › Sports Accessories (مستلزمات رياضية)", "Fashion › Man Clothes (ملابس رجالية)", "Fashion › Perfumes and Incense (عطورات)", "Fashion › Watches (ساعات)", "Fashion › Health and beauty (الصحة والجمال)", "Fashion › Gifts (هدايا)", "Fashion › Kids Clothes (ملابس أطفال)", "Fashion › Glasses (نظارات)", "Fashion › Luggage (أمتعة سفر)", "Animals (مواشي وحيوانات وطيور)", "Animals › Parrot (ببغاء)", "Animals › Sheep (غنم)", "Animals › Cats (قطط)", "Animals › Chicken (دجاج)", "Animals › Goats (ماعز)", "Animals › Camels (أبل)", "Animals › Pigeons (حمام)", "Animals › Horses (خيل)", "Animals › Dogs (كلاب)", "Animals › Fish and turtles (أسماك وسلاحف)", "Animals › Rabbits (ارانب)", "Animals › Duck (بط)", "Animals › Hyrax (وبر)", "Animals › cows (بقر)", "Animals › Hamsters (هامستر)", "Animals › Squirrels (سناجب)", "Jobs (وظائف)", "Jobs › Administrative functions (وظائف اداريه)", "Jobs › Home employment jobs (وظائف عمالة منزلية)", "Jobs › Jobs Restaurants (وظائف مطاعم)", "Jobs › Costumes and beauty jobs (وظائف ازياء وتجميل)", "Jobs › Industrial Jobs (وظائف صناعية)", "Jobs › Educational functions (وظائف تعليمية)", "Jobs › Jobs Medical and Nursing (وظائف طب وتمريض)", "Jobs › Building and building jobs (وظائف عمارة وبناء)", "Jobs › Security and safety jobs (وظائف امن وسلامة)", "Jobs › Technical and design functions (وظائف تقنية وتصميم)", "Jobs › Agricultural and grazing functions (وظائف زراعة ورعي)", "Games (العاب وترفيه)", "Coaching (تعليم وتدريب)", "Coaching › Private classes (دروس خصوصية)", "Coaching › Training courses (دورات تدريبية)", "Coaching › Sports Exercices (تدريب رياضي)", "Coaching › Leading (تعليم قيادة)", "Coaching › Electronic Games Training (تدريب العاب الكترونية)", "Coaching › Education shares and currencies (تعليم اسهم وعملات)", "Food (اطعمة ومشروبات)", "Events (حفلات ومناسبات)", "Coding (برمجة وتصاميم)", "Gardens (زراعة وحدائق)", "Rarities (نوادر و تراثيات)", "Projects and investments (مشاريع واستثمارات)", "Arts (مكتبة وفنون)", "Trips (صيد ورحلات)", "Tourism (سفر وسياحة)", "Tourism › Chalets (شاليهات للايجار)", "Tourism › roommate (شريك سكن)", "Tourism › Serviced Apartments (شقق مخدومة)", "Lost & Found (مفقودات)", "More (قسم غير مصنف)" ] } }, "tags": { "title": "Tags (Arabic)", "type": "array", "description": "Any Haraj tag, written as on the site, for deeper levels: a car model (\"كامري\"), a model and year (\"كامري 2020\"), a property type in a city (\"شقق للايجار في الرياض\").", "items": { "type": "string" } }, "searchTerms": { "title": "Keywords", "type": "array", "description": "Words to search, like \"كامري\", \"ايفون 15\" or \"iphone\". With categories or tags, each keyword runs inside each of them.", "items": { "type": "string" } }, "regions": { "title": "Regions and cities", "type": "array", "description": "Where the ad is (100). Pick a region for all its cities, or a single city.", "items": { "type": "string", "enum": [ "الرياض", "الخرج", "الدرعية", "الدلم", "الدوادمي", "الحريق", "الزلفي", "السليل", "الغاط", "القويعية", "المجمعة", "المزاحمية", "الهياثم", "ثادق", "حوطة بني تميم", "رماح", "شقراء", "عفيف", "الشرقيه", "الدمام", "الخبر", "الظهران", "الجبيل", "حفر الباطن", "الهفوف", "تاروت", "المبرز", "العيون", "النعيرية", "بقيق", "راس تنورة", "الخفجي", "القطيف", "سيهات", "صفوى", "عنك", "جده", "مكه", "الطايف", "القنفذة", "الكامل", "الليث", "تربة مكة", "ثول", "الجموم", "رابغ", "رنية", "مدينة الملك عبدالله الاقتصادية", "الخرمة", "ينبع", "المدينة", "العلا", "الحناكية", "بدر", "خيبر", "مهد الذهب", "تبوك", "املج", "الوجه", "تيماء", "ضبا", "القصيم", "بريدة", "عنيزة", "الرس", "الشماسية", "المذنب", "النبهانية", "البدائع", "رياض الخبراء", "البكيرية", "حائل", "الغزالة", "بقعاء", "الشنان", "تربة حائل", "أبها", "عسير", "خميس مشيط", "المجاردة", "بللسمر", "بيشة", "تثليث", "احد رفيده", "محايل عسير", "الباحة", "جيزان", "نجران", "شرورة", "الوديعة", "الجوف", "القريات", "دومة الجندل", "سكاكا", "عرعر", "رفحاء", "طريف", "الكويت", "الإمارات", "البحرين" ], "enumTitles": [ "Riyadh region (الرياض)", "Al-Kharj (الخرج)", "Ad Diriyah (الدرعية)", "Ad-Dilam (الدلم)", "Al Duwadimi (الدوادمي)", "Al Hariq (الحريق)", "Al Zulfi (الزلفي)", "Al Sulayyil (السليل)", "Al-Ghat (الغاط)", "Al Quwaiiyah (القويعية)", "Al Majma'ah (المجمعة)", "Al-Muzahmiya (المزاحمية)", "Al Hayathem (الهياثم)", "Thadiq (ثادق)", "Howtat Bani Tamim (حوطة بني تميم)", "Rumah (رماح)", "Shaqra (شقراء)", "Afif (عفيف)", "Eastern Region region (الشرقيه)", "Dammam (الدمام)", "Al Khobar (الخبر)", "Dhahran (الظهران)", "Al Jubail (الجبيل)", "Hafar Al Batin (حفر الباطن)", "Al Hofuf (الهفوف)", "Tarout (تاروت)", "Al Mubarraz (المبرز)", "Al Oyun (العيون)", "Nairyah (النعيرية)", "Buqayq (بقيق)", "Ras Tanura (راس تنورة)", "Khafji (الخفجي)", "Al Qatif (القطيف)", "Saihat (سيهات)", "Safwa (صفوى)", "Anak (عنك)", "Jeddah region (جده)", "Makkah region (مكه)", "Taif (الطايف)", "Al Qunfudhah (القنفذة)", "Al Kamil (الكامل)", "Al Lith (الليث)", "Turbah (تربة مكة)", "Thuwal (ثول)", "Al-Jumum (الجموم)", "Rabigh (رابغ)", "Ranyah (رنية)", "King Abdullah Economic City (مدينة الملك عبدالله الاقتصادية)", "Al Khurma (الخرمة)", "Yanbu region (ينبع)", "Madinah region (المدينة)", "AlUla (العلا)", "Al Hinakiyah (الحناكية)", "Badr (بدر)", "Khaybar (خيبر)", "Mahd Al Thahab (مهد الذهب)", "Tabouk region (تبوك)", "Umluj (املج)", "Al Wajh (الوجه)", "Tayma (تيماء)", "Duba (ضبا)", "Qassim region (القصيم)", "Buraydah (بريدة)", "Unayzah (عنيزة)", "Ar Rass (الرس)", "Al Shimasiyah (الشماسية)", "Al Mithnab (المذنب)", "Al Nabhaniyah (النبهانية)", "Al Badayea (البدائع)", "Riyadh Al Khabra (رياض الخبراء)", "Al Bukayriyah (البكيرية)", "Hail region (حائل)", "Al Ghazalah (الغزالة)", "Baqaa (بقعاء)", "Al Shinan (الشنان)", "Trubah (تربة حائل)", "Abha region (أبها)", "Aseer region (عسير)", "Khamis Mushait (خميس مشيط)", "Almajaridah (المجاردة)", "Billasmar (بللسمر)", "Bisha (بيشة)", "Tathleeth (تثليث)", "Ahad Rafidah (احد رفيده)", "Muhayil (محايل عسير)", "Bahah region (الباحة)", "Jazan region (جيزان)", "Najran region (نجران)", "Sharorah (شرورة)", "Al-Wadiah (الوديعة)", "Jouf region (الجوف)", "Qurayyat (القريات)", "Dumah Al Jandal (دومة الجندل)", "Sakaka (سكاكا)", "Arar region (عرعر)", "Rafha (رفحاء)", "Turaif (طريف)", "Kuwait region (الكويت)", "UAE region (الإمارات)", "Bahrain region (البحرين)" ] } }, "sellers": { "title": "Sellers", "type": "array", "description": "Haraj usernames (as in haraj.com.sa/users/): all their ads.", "items": { "type": "string" } }, "minPrice": { "title": "Minimum price (SAR)", "minimum": 0, "type": "integer", "description": "Only ads with a price from this amount. Ads without a price are skipped." }, "maxPrice": { "title": "Maximum price (SAR)", "minimum": 0, "type": "integer", "description": "Only ads with a price up to this amount. Ads without a price are skipped." }, "onlyWithPrice": { "title": "Only ads with a price", "type": "boolean", "description": "Skip ads where the seller wrote no price (most Haraj ads have none)." }, "onlyWithImages": { "title": "Only ads with photos", "type": "boolean", "description": "Skip ads without photos." }, "onlyWithVideo": { "title": "Only ads with video", "type": "boolean", "description": "Only ads that have a video." }, "postedWithinDays": { "title": "Posted in the last N days", "minimum": 1, "type": "integer", "description": "Only ads first posted this many days ago or less." }, "hideShowrooms": { "title": "Hide showrooms", "type": "boolean", "description": "Skip ads from car showrooms and dealers, as the site's own option does." }, "carFuel": { "title": "Fuel", "enum": [ "GASOLINE", "DIESEL", "HYBRID", "ELECTRIC" ], "type": "string", "description": "Engine type." }, "carGearbox": { "title": "Gearbox", "enum": [ "AUTO", "MANUAL" ], "type": "string", "description": "Automatic or manual." }, "carCondition": { "title": "Condition", "enum": [ "NEW", "USED", "USED_AS_NEW", "USED_EXCELLENT", "USED_GOOD", "USED_NOT_GOOD", "DAMGED" ], "type": "string", "description": "New, used or damaged." }, "carDeal": { "title": "Deal", "enum": [ "SELL", "WAIVER" ], "type": "string", "description": "Sale, or lease transfer (تنازل: taking over a car loan)." }, "carFourWheelDrive": { "title": "4x4 only", "type": "boolean", "description": "Only cars marked as four-wheel drive." }, "carMinYear": { "title": "Year from", "minimum": 1900, "type": "integer", "description": "Only cars of this model year or later." }, "carMaxYear": { "title": "Year to", "minimum": 1900, "type": "integer", "description": "Only cars of this model year or earlier." }, "carMinMileage": { "title": "Minimum mileage (thousand km)", "minimum": 0, "type": "integer", "description": "Only cars with at least this many thousand kilometers (as the seller entered it)." }, "carMaxMileage": { "title": "Maximum mileage (thousand km)", "minimum": 0, "type": "integer", "description": "Only cars with at most this many thousand kilometers (as the seller entered it)." }, "onlyNew": { "title": "Only new ads", "type": "boolean", "description": "Skip ads saved by earlier runs with the same monitor name." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Runs with the same name share their history. Use a different name for each schedule." }, "startUrls": { "title": "Links", "type": "array", "description": "Haraj ad pages (https://haraj.com.sa/11192266811/...), category pages (https://haraj.com.sa/tags/حراج السيارات), city pages (/city/الرياض), seller pages (/users/) or search pages (/search/كامري).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }