{ "openapi": "3.0.1", "info": { "title": "Haraj Scraper & API حراج (2026) 🇸🇦", "description": "Haraj scraper and unofficial Haraj API to extract listings from Haraj.com.sa. Scrape cars, real estate, electronics, jobs, and 20+ categories. Filter by city, category, seller, or keyword. Get structured data with prices, images, seller info, and location from Saudi Arabia's largest marketplace.", "version": "0.0", "x-build-id": "lh8BlacUQEqKTLPaJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~haraj-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-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/zen-studio~haraj-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-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/zen-studio~haraj-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-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": { "search": { "title": "Search keyword", "type": "string", "description": "Search keyword (e.g. 'iphone', 'toyota'). Leave empty to browse by category/city." }, "tag": { "title": "Category", "enum": [ "", "حراج السيارات", "حراج العقار", "حراج الأجهزة", "مواشي وحيوانات وطيور", "اثاث", "وظائف", "خدمات", "مستلزمات شخصية", "العاب وترفيه", "نوادر و تراثيات", "مكتبة وفنون", "صيد ورحلات", "اطعمة ومشروبات", "زراعة وحدائق", "حفلات ومناسبات", "سفر وسياحة", "مفقودات", "تعليم وتدريب", "برمجة وتصاميم", "مشاريع واستثمارات", "قسم غير مصنف" ], "type": "string", "description": "Filter by category", "default": "" }, "city": { "title": "City / Region", "enum": [ "", "الرياض", "الخرج", "الدرعية", "الدلم", "الدوادمي", "الحريق", "الزلفي", "السليل", "الغاط", "القويعية", "المجمعة", "المزاحمية", "الهياثم", "ثادق", "حوطة بني تميم", "رماح", "شقراء", "عفيف", "الشرقيه", "الدمام", "الخبر", "الظهران", "الجبيل", "حفر الباطن", "الهفوف", "تاروت", "المبرز", "العيون", "النعيرية", "بقيق", "راس تنورة", "الخفجي", "القطيف", "سيهات", "صفوى", "عنك", "جده", "مكه", "الطايف", "القنفذة", "الكامل", "الليث", "تربة مكة", "ثول", "الجموم", "رابغ", "رنية", "مدينة الملك عبدالله الاقتصادية", "الخرمة", "ينبع", "المدينة", "العلا", "الحناكية", "بدر", "خيبر", "مهد الذهب", "تبوك", "املج", "الوجه", "تيماء", "ضبا", "القصيم", "بريدة", "عنيزة", "الرس", "الشماسية", "المذنب", "النبهانية", "البدائع", "رياض الخبراء", "البكيرية", "حائل", "الغزالة", "بقعاء", "الشنان", "تربة حائل", "أبها", "عسير", "خميس مشيط", "المجاردة", "بللسمر", "بيشة", "تثليث", "احد رفيده", "محايل عسير", "الباحة", "جيزان", "نجران", "شرورة", "الوديعة", "الجوف", "القريات", "دومة الجندل", "سكاكا", "عرعر", "رفحاء", "طريف", "الكويت", "الإمارات", "البحرين" ], "type": "string", "description": "Filter by city or region", "default": "" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of listings to scrape", "default": 100 }, "duringDate": { "title": "Time period", "enum": [ "", "1days", "3days", "1week", "1months" ], "type": "string", "description": "Filter by posting date. Only applies when searching with a keyword.", "default": "" }, "onlyWithImage": { "title": "Only with images", "type": "boolean", "description": "Only return listings that have images", "default": false }, "authorUsername": { "title": "Seller username", "type": "string", "description": "Filter by specific seller username. When set, keyword search is ignored and browse mode is used instead." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings for reliable access", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } }, "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 } } } } } } } } } }