# Haraj Scraper: KSA Classified Listings (`getascraper/haraj-scraper`) Actor Extract Saudi listings from Haraj.com.sa. Download cars, real estate, electronics, prices, image lists, and specifications in under 10 seconds. Perfect for price comparison, market intelligence, and liquidation arbitrage. Skip manual copying. $2.99 per 1k results. - **URL**: https://apify.com/getascraper/haraj-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 1,000 listing scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Haraj scraper: Saudi Arabia classifieds Get live classified listings from Haraj.com.sa (Saudi Arabia's largest marketplace) ready for your spreadsheet in under 10 seconds. Download clean cars, real estate, electronics, pricing, locations, and specifications in Arabic and English, completely optimized for reselling and market intelligence. --- ### What can you do with it? * **I am a car dealer or reseller** looking to monitor price benchmarks and active vehicle listings across specific models, years, and mileages in Saudi Arabia. * **I am a real estate analyst** tracking historical property valuations, areas, and listing activity across major Saudi regions. * **I am an e-commerce vendor** backfilling localized Saudi electronic and consumer goods inventory into my own directories. --- ### How to scrape Haraj data step-by-step 1. Create a free Apify account. 2. Open the **Haraj Scraper** in the Apify Store. 3. Enter your product search keywords (e.g. `toyota`, `iphone`, or `شقة`). 4. Select the target category (e.g. Cars, Real Estate, Devices) or target city. 5. Click **Start** and download your structured Saudi marketplace dataset as JSON, CSV, or Excel. --- ### Input | Field | Type | Required | Description | | :--- | :--- | :--- | :--- | | `search` | `string` | No | Search keyword (e.g. `iphone`, `toyota`). Leave empty to browse by category or city. | | `tag` | `enum` | No | Filter by category (e.g. Cars, Real Estate, Devices, Furniture, Jobs). | | `city` | `enum` | No | Filter by specific Saudi Arabian city or region (e.g. Riyadh, Jeddah, Eastern Region). | | `duringDate` | `enum` | No | Only return listings posted within this time period (Last 24 Hours, 3 Days, Week, or Month). | | `onlyWithImage` | `boolean` | No | Only return listings that contain images. | | `authorUsername` | `string` | No | Filter listings posted by a specific seller username. | | `maxItems` | `integer` | Yes | Maximum number of listing records to extract. | | `proxyConfiguration` | `object` | Yes | Proxy options. Pre-configured residential proxies are recommended to guarantee clean and unblocked regional access. | --- ### Output Each row represents a single marketplace listing. The dataset is completely flat with no nested JSON structures, ensuring perfect exports to CSV, Excel, or Google Sheets. ```json { "id": "182466169", "url": "https://haraj.com.sa/11182466169/تويوتا_هايس_2026_الجديدة/", "title": "تويوتا هايس 2026 الجديدة", "body": "تويوتا هايس 2026 ركاب جديد ديزل ارتفاع كامل اتصل بنا...", "authorUsername": "مؤسسة مسارات النظم", "authorId": "20163797", "city": "الرياض", "geoCity": "الرياض", "geoNeighborhood": "الملز", "postDate": "2026-06-15T08:48:15.000Z", "updateDate": "2026-06-15T08:48:15.000Z", "tags": "حراج السيارات, تويوتا, باص, باص 2026, باص, ركاب", "hasImage": true, "hasVideo": false, "thumbnailUrl": "https://mimg6cdn.haraj.com.sa/userfiles30/405x900-1_-AhGsmMBx7flhl5.jpg-140x140.webp", "imagesList": "https://mimg6cdn.haraj.com.sa/userfiles30/2026-6-15/405x900-1_-AhGsmMBx7flhl5.jpg, https://mimg6cdn.haraj.com.sa/userfiles30/2026-6-15/900x405-1_-40tinaS7cON82L.jpg", "price": "190000", "formattedPrice": "190,000", "commentCount": 0, "upRank": 0, "downRank": 0, "isPromoted": false, "postType": "AD", "carModel": 2026, "carOrRelated": "CAR", "sellOrWaiver": "SELL", "carMileage": null, "carFuel": "DIESEL", "carGear": "AUTO", "carCondition": null, "scrapedAt": "2026-06-15T10:51:10.367Z" } ```` #### Field reference | Field | Type | Description | | :--- | :--- | :--- | | `id` | `string` | Unique identifier of the listing on Haraj. | | `url` | `string` | Canonical link to the listing page. | | `title` | `string` | Listing display title. | | `body` | `string` | Full listing description text (Arabic or English). | | `authorUsername` | `string` | Username of the posting seller. | | `authorId` | `string` | Unique profile ID of the posting seller. | | `city` | `string` | Broad region name of the listing (e.g. Riyadh, Jeddah). | | `geoCity` | `string` | Specific city location of the listing. | | `geoNeighborhood` | `string` | Local neighborhood name of the listing. | | `postDate` | `string` | ISO timestamp of when the listing was created. | | `updateDate` | `string` | ISO timestamp of when the listing was last updated. | | `tags` | `string` | Comma-separated category tags. | | `hasImage` | `boolean` | True if the listing has photos. | | `hasVideo` | `boolean` | True if the listing has video attachments. | | `thumbnailUrl` | `string` | Fully-resolved absolute CDN thumbnail image link. | | `imagesList` | `string` | Comma-separated high-resolution photo URLs. | | `price` | `string` | Parsed numeric price value. | | `formattedPrice` | `string` | Formatted price text (e.g. 190,000 SAR). | | `commentCount` | `integer` | Total comments posted on this listing. | | `upRank` | `integer` | Up-vote rating count. | | `downRank` | `integer` | Down-vote rating count. | | `isPromoted` | `boolean` | True if this is a sponsored or featured listing. | | `postType` | `string` | Classified format type (always AD). | | `carModel` | `integer` | Vehicle model year (if car listing). | | `carOrRelated` | `string` | Vehicle classification tag (CAR or RELATED). | | `sellOrWaiver` | `string` | Sale terms (SELL or WAIVER). | | `carMileage` | `integer` | Vehicle mileage odometer value in thousands (if car listing). | | `carFuel` | `string` | Vehicle fuel category (DIESEL or GASOLINE). | | `carGear` | `string` | Transmission type (AUTO or MANUAL). | | `carCondition` | `string` | General vehicle condition (USED or NEW). | | `scrapedAt` | `string` | ISO timestamp of when the row was scraped. | *** ### Pricing and cost Pricing is pay-per-result and is billed per row successfully saved to your dataset. Empty runs cost absolutely nothing. - Rate: **$2.99 per 1,000 results** ($0.00299 per result). - 100 listings typically cost **$0.30**. - 1,000 listings cost exactly **$2.99**. - 10,000 listings cost exactly **$29.90**. - No fixed monthly subscriptions or hidden maintenance fees. *** ### Tips and best practices - **Filter by city.** To capture localized price intelligence in under 10 seconds, configure specific KSA cities (such as Riyadh or Jeddah) directly in your filters. - **Bypass browser rendering.** This scraper connects directly to unblocked regional data pipes. It bypasses slow browser loading, cutting your runtime and compute duration bills by 90%. *** ### FAQ ##### Does it get blocked by Haraj? No. The scraper natively routes through premium Residential Proxies by default. This makes the automated traffic appear identical to regular domestic Saudi Arabian users, bypassing regional blocks cleanly. ##### Does it extract seller phone numbers? No. To protect user privacy and comply with global data regulations, the scraper does not extract private seller profiles or contact phone numbers. It only retrieves public vacancies, listing descriptions, specifications, prices, and seller names. ##### How fresh is the data? Extremely fresh. The scraper executes live requests on every query, retrieving the absolute latest classified listings posted on Haraj in real-time. ##### Are all regions supported? Yes. The scraper supports all major regions across Saudi Arabia, as well as listings from Kuwait, the UAE, and Bahrain. *** ### Target SEO keywords - Haraj API - scrape Haraj Saudi Arabia - Saudi classifieds data - Riyadh real estate scraper - KSA cars database *** ### Disclaimers and support - **Disclaimer:** This Actor retrieves publicly available classified job and product listings on Haraj. Make sure your usage complies with Haraj Terms of Service and applicable laws. - **Support:** Open an issue from the Actor page in the Apify Console for bug reports or feature requests. # Actor input Schema ## `search` (type: `string`): Product search keyword (e.g. 'iphone', 'toyota'). Leave empty to browse by category/city. ## `tag` (type: `string`): Filter listings by standard Arabic category tag. ## `city` (type: `string`): Filter by Saudi Arabian city or region. ## `duringDate` (type: `string`): Only return listings posted within this time period. Note: Only applies with keyword search. ## `onlyWithImage` (type: `boolean`): Only return listings that contain images. ## `authorUsername` (type: `string`): Filter listings posted by a specific seller username on Haraj. ## `maxItems` (type: `integer`): Maximum number of listing records to extract (0 for unlimited). ## `proxyConfiguration` (type: `object`): REQUIRED. Pre-configured Middle East or Apify Residential proxies recommended. ## Actor input object example ```json { "search": "iphone", "tag": "", "city": "", "duringDate": "", "onlyWithImage": false, "authorUsername": "", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "search": "iphone", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/haraj-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "search": "iphone", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/haraj-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "search": "iphone", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call getascraper/haraj-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/haraj-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Haraj Scraper: KSA Classified Listings", "description": "Extract Saudi listings from Haraj.com.sa. Download cars, real estate, electronics, prices, image lists, and specifications in under 10 seconds. Perfect for price comparison, market intelligence, and liquidation arbitrage. Skip manual copying. $2.99 per 1k results.", "version": "0.1", "x-build-id": "oCyAVSAvzlYfBOofa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~haraj-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-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/getascraper~haraj-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-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/getascraper~haraj-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-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", "required": [ "maxItems", "proxyConfiguration" ], "properties": { "search": { "title": "Search Keyword", "type": "string", "description": "Product search keyword (e.g. 'iphone', 'toyota'). Leave empty to browse by category/city.", "default": "iphone" }, "tag": { "title": "Category", "enum": [ "", "حراج السيارات", "حراج العقار", "حراج الأجهزة", "مواشي وحيوانات وطيور", "اثاث", "وظائف", "خدمات", "مستلزمات شخصية", "العاب وترفيه", "نوادر و تراثيات", "مكتبة وفنون", "صيد ورحلات", "اطعمة ومشروبات", "زراعة وحدائق", "حفلات ومناسبات", "سفر وسياحة", "مفقودات", "تعليم وتدريب", "برمجة وتصاميم", "مشاريع واستثمارات", "قسم غير مصنف" ], "type": "string", "description": "Filter listings by standard Arabic category tag.", "default": "" }, "city": { "title": "City / Region", "enum": [ "", "الرياض", "جده", "الشرقيه", "مكه", "المدينة", "تبوك", "القصيم", "حائل", "عسير", "الباحة", "جيزان", "نجران", "الجوف", "عرعر", "الكويت", "الإمارات", "البحرين" ], "type": "string", "description": "Filter by Saudi Arabian city or region.", "default": "" }, "duringDate": { "title": "Posting Date", "enum": [ "", "1days", "3days", "1week", "1months" ], "type": "string", "description": "Only return listings posted within this time period. Note: Only applies with keyword search.", "default": "" }, "onlyWithImage": { "title": "Only with Images", "type": "boolean", "description": "Only return listings that contain images.", "default": false }, "authorUsername": { "title": "Seller Username", "type": "string", "description": "Filter listings posted by a specific seller username on Haraj.", "default": "" }, "maxItems": { "title": "Maximum Items", "minimum": 0, "type": "integer", "description": "Maximum number of listing records to extract (0 for unlimited).", "default": 10 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "REQUIRED. Pre-configured Middle East or Apify Residential proxies recommended.", "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 } } } } } } } } } } ```