# OpenSooq Scraper: MENA Classifieds & Cars (`getascraper/opensooq-scraper`) Actor Scrape product listings, cars, and real estate from OpenSooq across Jordan, Saudi Arabia, UAE, and 17 MENA countries. Get clean lists of prices, specifications, locations, and images with zero browser overhead. $2.99 per 1,000 results. - **URL**: https://apify.com/getascraper/opensooq-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 ## OpenSooq scraper: MENA classifieds and cars Scrape product listings, cars, and real estate from OpenSooq across Jordan, Saudi Arabia, UAE, and 17 MENA countries. Get clean lists of prices, specifications, locations, and images ready for your spreadsheet in under 10 seconds. Perfect for auto dealers, real estate agencies, price comparison trackers, and market intelligence. --- ### What can you do with it? * **I am an auto dealer or reseller** looking to monitor price benchmarks and active vehicle listings across specific models, years, and mileages in the Middle East. * **I am a real estate agent** tracking historical property valuations, areas, and listing activity across major cities like Amman or Riyadh. * **I am a market-research analyst** building weekly reports on consumer demand and pricing strategies in the MENA retail space. --- ### How to scrape OpenSooq data step-by-step 1. Create a free Apify account. 2. Open the **OpenSooq Scraper** in the Apify Store. 3. Select your target country (e.g. Jordan, Saudi Arabia, or UAE). 4. Enter your search keyword (e.g. `iphone`, `toyota`, or `شقة`). 5. Click **Start** and download your structured MENA marketplace dataset as JSON, CSV, or Excel. --- ### Input | Field | Type | Required | Description | | :--- | :--- | :--- | :--- | | `site` | `enum` | Yes | Select which OpenSooq country site to scrape (Jordan, Saudi Arabia, UAE, Kuwait, etc.). | | `query` | `string` | No | Text keyword to search for (e.g., `iphone`, `apartment`, `bmw`). Leave empty to browse all. | | `category` | `enum` | No | Filter by category (e.g. Autos, Mobile, Property For Sale, Jobs). | | `city` | `string` | No | Filter by city name or ID (e.g., `Amman`, `Riyadh`). | | `neighborhood` | `string` | No | Filter by specific neighborhood name. Requires a City to be set first. | | `priceFrom` | `integer` | No | Only include listings priced at or above this value. | | `priceTo` | `integer` | No | Only include listings priced at or below this value. | | `sortBy` | `enum` | No | Sort results in the listings search (Newest First, Recommended, Price: High to Low, Price: Low to High). | | `hasImages` | `boolean` | No | Only return listings containing image galleries. | | `hasPrice` | `boolean` | No | Only return listings that disclose an explicit price. | | `isShop` | `boolean` | No | Only return listings posted by registered business shops. | | `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": "276150375", "url": "https://jo.opensooq.com/ar/search/276150375", "title": "190 m2 3 Bedrooms Apartments for Sale in Zarqa Dahiet Al Madena Al Monawwara", "descriptionPreview": "شقة طابقية مميزة تشطيبات فندقية عالية الجودة مكونة من 3 غرف نوم...", "price": "66,000", "currency": "JOD", "city": "Zarqa", "neighborhood": "Dahiet Al Madena Al Monawwara", "category": "Property For Sale", "imageUrl": "https://opensooq-images.os-cdn.com/previews/700x0/a9/ab/a9abf520684bb5399eb5f27fc4620d01dc354b6e19860aa901257c8343f65565.jpg", "memberDisplayName": "mohamad abo khadra", "phoneNumber": "07996786XX", "phoneRevealKey": "0cd4416532a0ce20860ce546ba8dc236", "scrapedAt": "2026-06-15T12:38:09.000Z" } ```` #### Field reference | Field | Type | Description | | :--- | :--- | :--- | | `id` | `string` | Unique identifier of the listing on OpenSooq. | | `url` | `string` | Canonical link to the listing page. | | `title` | `string` | Listing display title. | | `descriptionPreview` | `string` | Short preview text of the listing description. | | `price` | `string` | Numeric price value parsed from the listing. | | `currency` | `string` | ISO currency code (e.g. JOD, SAR, AED). | | `city` | `string` | Name of the city location (English or Arabic). | | `neighborhood` | `string` | Local neighborhood name of the listing. | | `category` | `string` | Major category classification of the listing. | | `imageUrl` | `string` | Primary lot cover photo URL. | | `memberDisplayName` | `string` | Public display name of the hosting seller. | | `phoneNumber` | `string` | Masked phone number (last 2 digits hidden by OpenSooq). | | `phoneRevealKey` | `string` | Security key used to request full number on platform. | | `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 - **Specify a country proxy.** OpenSooq geolocates search results based on visitor IPs. Always configure your proxy configuration to route through the target country (e.g., `country-JO` for Jordan, `country-SA` for Saudi Arabia) to secure KSA-localized listing speeds and density. - **Bypass browser overhead.** This scraper uses unblocked direct server data extraction, skipping slow web page loadings. This cuts your runtimes and platform compute costs by 90%! *** ### FAQ ##### Does it get blocked by OpenSooq? No. The scraper natively routes through regional Residential Proxies by default. This makes the automated traffic appear identical to regular domestic MENA users, bypassing regional blocks cleanly. ##### Does it extract full seller phone numbers? No. Phone numbers are masked by OpenSooq (last 2 digits hidden, e.g., `07996786XX`) to prevent spam. The `phoneRevealKey` field is provided for reference, but full unmasking requires manual authentication on the OpenSooq platform. ##### How fresh is the data? Extremely fresh. The scraper executes live requests on every query, retrieving the absolute latest classified listings posted on OpenSooq in real-time. ##### Are all 20 countries supported? Yes. The scraper supports Jordan, Saudi Arabia, UAE, Kuwait, Bahrain, Oman, Qatar, Iraq, Egypt, Yemen, Libya, Sudan, Lebanon, Palestine, Syria, Algeria, Morocco, Tunisia, Turkey, and Mauritania. *** ### Target SEO keywords - OpenSooq API - scrape OpenSooq Jordan - OpenSooq Saudi Arabia scraper - MENA classifieds database - Dubai car listings scraper *** ### Disclaimers and support - **Disclaimer:** This Actor retrieves publicly available classified job and product listings on OpenSooq. Make sure your usage complies with OpenSooq 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 ## `site` (type: `string`): Select which OpenSooq country site to scrape. ## `query` (type: `string`): Text keyword to search for (e.g., 'iphone', 'apartment', 'bmw'). Leave empty if using Bulk Queries below. ## `queries` (type: `array`): Paste multiple keywords to search and scrape simultaneously in a single bulk run. ## `category` (type: `string`): Filter listings by major categories. ## `city` (type: `string`): City name (e.g., 'Amman', 'Riyadh') or numeric city ID. Leave empty for all. ## `neighborhood` (type: `string`): Neighborhood name or numeric ID. Requires a City to be set first. ## `priceFrom` (type: `integer`): Only return listings priced at or above this value. Leave empty for no minimum. ## `priceTo` (type: `integer`): Only return listings priced at or below this value. Leave empty for no maximum. ## `sortBy` (type: `string`): Order results in the listings search results. ## `hasImages` (type: `boolean`): Only return listings containing image galleries. ## `hasPrice` (type: `boolean`): Only return listings that disclose an explicit price. ## `isShop` (type: `boolean`): Only return listings posted by registered business shops. ## `unmaskPhones` (type: `boolean`): Attempt to unmask and extract complete mobile phone numbers for leads generation. ## `accessToken` (type: `string`): Optional Authorization token (Bearer JWT) used to successfully reveal phone numbers. Leave blank if not available. ## `maxItems` (type: `integer`): Maximum number of listing records to extract. ## `proxyConfiguration` (type: `object`): REQUIRED. Pre-configured residential proxies are recommended. ## Actor input object example ```json { "site": "sa", "query": "iphone", "queries": [], "category": "", "city": "", "neighborhood": "", "sortBy": "recent", "hasImages": false, "hasPrice": false, "isShop": false, "unmaskPhones": false, "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 = { "queries": [], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/opensooq-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 = { "queries": [], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/opensooq-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 '{ "queries": [], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call getascraper/opensooq-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/opensooq-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OpenSooq Scraper: MENA Classifieds & Cars", "description": "Scrape product listings, cars, and real estate from OpenSooq across Jordan, Saudi Arabia, UAE, and 17 MENA countries. Get clean lists of prices, specifications, locations, and images with zero browser overhead. $2.99 per 1,000 results.", "version": "0.1", "x-build-id": "tm4ySOhzX838t88bW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~opensooq-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-opensooq-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~opensooq-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-opensooq-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~opensooq-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-opensooq-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": [ "site", "maxItems", "proxyConfiguration" ], "properties": { "site": { "title": "Country Site", "enum": [ "jo", "sa", "ae", "kw", "bh", "om", "qa", "iq", "eg", "ye", "ly", "sd", "lb", "ps", "sy", "dz", "ma", "tn", "tr", "mr" ], "type": "string", "description": "Select which OpenSooq country site to scrape.", "default": "sa" }, "query": { "title": "Search Query", "type": "string", "description": "Text keyword to search for (e.g., 'iphone', 'apartment', 'bmw'). Leave empty if using Bulk Queries below.", "default": "iphone" }, "queries": { "title": "Bulk Search Queries", "type": "array", "description": "Paste multiple keywords to search and scrape simultaneously in a single bulk run.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "category": { "title": "Category", "enum": [ "", "1775", "5505", "2143", "13741", "2131", "7713", "8035", "2181", "54963", "54965", "7105", "88", "15981", "4275", "15061", "15101", "5141" ], "type": "string", "description": "Filter listings by major categories.", "default": "" }, "city": { "title": "City", "type": "string", "description": "City name (e.g., 'Amman', 'Riyadh') or numeric city ID. Leave empty for all.", "default": "" }, "neighborhood": { "title": "Neighborhood", "type": "string", "description": "Neighborhood name or numeric ID. Requires a City to be set first.", "default": "" }, "priceFrom": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Only return listings priced at or above this value. Leave empty for no minimum." }, "priceTo": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Only return listings priced at or below this value. Leave empty for no maximum." }, "sortBy": { "title": "Sort Order", "enum": [ "recent", "default", "price-", "price+" ], "type": "string", "description": "Order results in the listings search results.", "default": "recent" }, "hasImages": { "title": "Only with Images", "type": "boolean", "description": "Only return listings containing image galleries.", "default": false }, "hasPrice": { "title": "Only with listed Price", "type": "boolean", "description": "Only return listings that disclose an explicit price.", "default": false }, "isShop": { "title": "Only Business Shops", "type": "boolean", "description": "Only return listings posted by registered business shops.", "default": false }, "unmaskPhones": { "title": "Auto-Unmask Phone Numbers", "type": "boolean", "description": "Attempt to unmask and extract complete mobile phone numbers for leads generation.", "default": false }, "accessToken": { "title": "OpenSooq Access Token (JWT)", "type": "string", "description": "Optional Authorization token (Bearer JWT) used to successfully reveal phone numbers. Leave blank if not available." }, "maxItems": { "title": "Maximum Items", "minimum": 1, "type": "integer", "description": "Maximum number of listing records to extract.", "default": 10 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "REQUIRED. Pre-configured residential proxies are 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 } } } } } } } } } } ```