Pricing

Rating

Developer

Actor stats

Categories

Share

OpenSooq Scraper | MENA Classifieds Data Extraction Across 20 Countries (2026)

Extract structured listing data from OpenSooq, the largest classifieds marketplace in the Middle East and North Africa. Covers 20 countries from Saudi Arabia and UAE to Egypt and Morocco. Returns 55 data fields per listing with zero data loss -- every property the platform provides, including structured attributes, AI-generated tags, seller details, and contact information.

👁 Demo

No OpenSooq account required. No cookies, no browser, no login.

Free tier: 5 runs included — try it before subscribing.

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

zen-studio/opensooq-scraper on Apify. Call:ApifyClient("TOKEN").actor("zen-studio/opensooq-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs:site(string,required:"jo"|"sa"|"ae"|"kw"|etc,20 countries),query(string),maxItems(integer,default100). Full actor spec(input schema with all params/enums/defaults, output dataset fields,README):GEThttps://api.apify.com/v2/acts/zen-studio~opensooq-scraper/builds/default(Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Pricing: rental $29/month, unlimited listings and runs, all 20 countries. Get token: https://console.apify.com/account/integrations

Rental Pricing

$29 per month -- unlimited listings, unlimited runs, all 20 countries.

• Scrape up to 50,000 listings per run
• All filtering options included
• Optional detail page enrichment for full descriptions and image galleries
• Cancel anytime

Quick Start

Basic -- Search Cars in Saudi Arabia

{
"site":"sa",
"query":"cars",
"maxItems":100
}

Advanced -- Filtered Real Estate in Amman

{
"site":"jo",
"query":"apartment",
"category":"7713",
"city":"Amman",
"priceFrom":30000,
"priceTo":100000,
"hasImages":true,
"sortBy":"recent",
"maxItems":500
}

Complete -- All Options

{
"site":"jo",
"query":"bmw",
"category":"1775",
"city":"Amman",
"neighborhood":"Swelieh",
"sortBy":"price-",
"priceFrom":5000,
"priceTo":25000,
"hasImages":true,
"hasPrice":true,
"isShop":false,
"fetchDetails":true,
"maxItems":1000,
"proxyConfiguration":{
"useApifyProxy":true,
"apifyProxyGroups":["RESIDENTIAL"],
"apifyProxyCountry":"JO"
}
}

Input Parameters

Categories

Select from the dropdown in Apify Console, or use the ID in API calls. Category IDs work across all 20 countries -- the scraper automatically resolves them to each country's internal IDs.

City and Neighborhood Input

Type a city name in English (e.g., Amman), Arabic (e.g., عمان), or pass a numeric ID directly. Fuzzy matching is built in -- Riyadh auto-resolves to Al Riyadh. Neighborhoods work the same way but require a city to be set first.

The full list of 600 cities across all 20 countries is available in the cities_by_country.json reference file. Common cities:

Jordan: Amman (59), Irbid (60), Zarqa (83), Aqaba (61), Salt (92)

Saudi Arabia: Al Riyadh (24), Jeddah (26), Dammam (25), Mecca (29), Medina (30)

UAE: Dubai (19), Abu Dhabi (17), Sharjah (20), Ajman (18), Al Ain (21)

Egypt: Cairo (2), Alexandria (3), Giza (4), Mansoura (146)

Kuwait: Kuwait City (50), Hawally (52), Farwaniya (53)

Output Data

Each listing includes up to 55 fields organized into these groups:

Core -- id, title, descriptionPreview, fullDescription, url

Price -- price (formatted with currency symbol), currency (ISO code)

Location -- city, cityId, cityReporting, neighborhood, neighborhoodId, neighborhoodReporting

Category -- category, categoryCode, categoryUri, subcategory, subcategoryCode, subcategoryUri

Images and Media -- imageUrl, imageCount, hasVideo, has360, hasYoutube, hasReels, reels

Seller -- memberId, memberName, memberUsername, memberAvatarUrl, memberRating, memberRatingCount, memberBadges, verificationLevel

Contact -- phone (masked), hasPhone, phoneRevealKey

Dates and Status -- postedAt, insertedDate, expiredAt, isActive, listingStatus, userTargetType, postBadges

Structured Attributes -- highlightsSummary (one-line summary), highlights (structured key-value attributes like make, model, year, bedrooms, area), aiTags (AI-generated classification tags), cps (compact property strings)

Internal -- booleans, unitsObj, addons, sliderActions, shareDeepLink, bookmarkStatus

Detail Enrichment (when fetchDetails is enabled) -- fullDescription, allImages

Meta -- scrapedAt (ISO 8601 timestamp)

Output Example -- Real Estate with Detail Enrichment

{
"id":276150375,
"title":"190 m2 3 Bedrooms Apartments for Sale in Zarqa Dahiet Al Madena Al Monawwara",
"descriptionPreview":"شقة طابقية مميزة تشطيبات فندقية عالية الجودة مكونة من 3 غرف نوم منهم واحدة ماستر و3 حمامات وغرفة ضيوف ومطبخ وصالة واسعة وبلكونة…",
"url":"https://jo.opensooq.com/search/276150375",
"price":"66,000 JOD",
"currency":"JOD",
"city":"Zarqa",
"cityId":"83",
"cityReporting":"Zarqa",
"neighborhood":"Dahiet Al Madena Al Monawwara",
"neighborhoodId":"7065",
"neighborhoodReporting":"Dahiet Al Madena Al Monawwara",
"category":"Property For Sale",
"categoryCode":"RealEstateForSale",
"categoryUri":"property/property-for-sale",
"subcategory":"Apartments for Sale",
"subcategoryCode":"ApartmentsForSale",
"subcategoryUri":"apartments-for-sale",
"imageUrl":"https://opensooq-images.os-cdn.com/previews/700x0/a9/ab/a9abf520684bb5399eb5f27fc4620d01dc354b6e19860aa901257c8343f65565.jpg",
"imageCount":26,
"hasVideo":1,
"has360":0,
"hasYoutube":0,
"hasReels":1,
"reels":[
{
"id":"1550824081",
"mime_type":"video/mp4",
"uri":"ad/dc/addc438dec48adc1727c1da2197e5613e34f0fa4.mp4"
}
],
"memberId":"4180997",
"memberName":"mohamad abo khadra",
"memberUsername":"mohammad_abokhadra",
"memberAvatarUrl":"https://opensooq-images.os-cdn.com/previews/200x0/dd/f8/ddf8498eaf0b99c16a48fca036336c004f63da2d3357740572788b8d57379243.jpg",
"memberRating":5,
"memberRatingCount":7,
"memberBadges":[],
"verificationLevel":0,
"phone":"07996786XX",
"hasPhone":1,
"phoneRevealKey":"0cd4416532a0ce20860ce546ba8dc236",
"postedAt":"",
"insertedDate":"2026-01-23",
"expiredAt":"24-03-2026",
"isActive":true,
"listingStatus":"reposted",
"userTargetType":"free",
"postBadges":[
"add_on_chat"
],
"highlightsSummary":"3 Bedrooms » 3 Bathrooms » 190 m2",
"highlights":{
"Rooms":[
{
"id":2481,
"field_id":17,
"value":"3",
"label":"3 Bedrooms"
}
],
"Bathrooms":[
{
"id":2519,
"field_id":25,
"value":"3",
"label":"3 Bathrooms"
}
],
"Furnished_RealEstate":[
{
"id":4729,
"field_id":101,
"value":"Not furnished",
"label":"Unfurnished"
}
],
"Surface":[
{
"id":31,
"value":"190",
"label":"Surface Area"
}
],
"Floors":[
{
"id":2505,
"field_id":21,
"value":"2",
"label":"Second Floor"
}
],
"Age_RealEstate":[
{
"id":6139,
"field_id":73,
"value":"Under Construction",
"label":"Under Construction"
}
],
"Main_amenities":[
{
"id":834,
"label":"Main Amenities"
}
]
},
"aiTags":[
"section: real estate",
"category: apartment",
"type: residential apartements",
"listing_type: rent",
"lister_type: agent",
"floor: not specified",
"area_sqm: wide",
"bedrooms: 3",
"features: high quality finishes",
"features: stone facades",
"features: double glazed windows",
"features: electric shutters",
"features: stainless steel railings",
"features: Italian elevator",
"bathrooms: 3",
"year_built: not specified",
"has_balcony: true",
"has_parking: not specified",
"location_ar: موقع مميز وهادئ بجانب الخدمات",
"location_en: Quiet prime location near amenities",
"has_elevator: true",
"has_security: true",
"is_furnished: true",
"has_electricity: true",
"has_water_supply: true"
],
"cps":[
"3 Bedrooms ",
"3 Bathrooms ",
"Unfurnished ",
"Surface Area: 190 m2",
"Second Floor ",
"Building Age: Under Construction "
],
"booleans":[],
"unitsObj":{
"Surface":{
"id":1,
"index":4
}
},
"addons":{
"contact":{
"chat":true
}
},
"sliderActions":[
"call",
"chats"
],
"shareDeepLink":"https://opensooq.com/site/dl?requestUri=${utm}$jo/post/276150375",
"bookmarkStatus":0,
"fullDescription":"شقة طابقية مميزة تشطيبات فندقية عالية الجودة مكونة من 3 غرف نوم منهم واحدة ماستر و3 حمامات وغرفة ضيوف ومطبخ وصالة واسعة وبلكونة مطلة على واجهات حجرية فاخرة مع شبابيك دبل جلاس وشتر كهربائي ودرابزين ستانلس ستيل ومصعد ايطالي وخزان ماء علوي",
"allImages":[
"https://opensooq-images.os-cdn.com/previews/2000x0/a9/ab/a9abf520684bb5399eb5f27fc4620d01dc354b6e19860aa901257c8343f65565.jpg"
],
"scrapedAt":"2026-02-06T06:47:20.418184+00:00"
}

Supported Countries

Full city list with IDs and Arabic names: cities_by_country.json

How to Scrape OpenSooq Listings with the API

Python

from apify_client import ApifyClient
client = ApifyClient("your_api_token")
run = client.actor("zen-studio/opensooq-scraper").call(run_input={
"site":"sa",
"query":"apartment",
"city":"Riyadh",
"category":"7713",
"priceFrom":100000,
"maxItems":500,
"proxyConfiguration":{
"useApifyProxy":True,
"apifyProxyGroups":["RESIDENTIAL"]
}
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(f"{item['title']} - {item['price']} in {item['city']}")

JavaScript

import{ ApifyClient }from'apify-client';
const client =newApifyClient({token:'your_api_token'});
const run =await client.actor('zen-studio/opensooq-scraper').call({
site:'jo',
query:'iphone',
hasImages:true,
sortBy:'recent',
maxItems:200,
proxyConfiguration:{
useApifyProxy:true,
apifyProxyGroups:['RESIDENTIAL']
}
});
const{ items }=await client.dataset(run.defaultDatasetId).listItems();
console.log(`Found ${items.length} listings`);

Advanced Usage

Scrape All Cars in a City with Price Filter

{
"site":"jo",
"query":"cars",
"category":"1775",
"city":"Amman",
"priceFrom":5000,
"priceTo":20000,
"hasImages":true,
"sortBy":"price-",
"maxItems":5000
}

Scrape Electronics Across Multiple Countries

Run separate Actor calls for each country with the same query:

{
"site":"ae",
"query":"iphone 15",
"hasPrice":true,
"sortBy":"recent",
"maxItems":1000
}

Full Data Extraction with Detail Pages

Enable fetchDetails for the complete description and all image URLs. This is slower (fetches each listing's detail page) but provides the most complete data:

{
"site":"sa",
"query":"villa",
"fetchDetails":true,
"maxItems":200
}

Technical Requirements

• Memory: 512 MB (default). Sufficient for up to 50,000 listings.
• Proxy: Residential proxy recommended for reliable results. Included in default configuration.
• Rate limits: Built-in retry logic with exponential backoff. No configuration needed.
• Run time: ~1 minute per 1,000 listings without detail enrichment. ~3-5 minutes per 1,000 with fetchDetails enabled.

Proxy Configuration

Residential proxy is recommended and pre-configured by default:

{
"proxyConfiguration":{
"useApifyProxy":true,
"apifyProxyGroups":["RESIDENTIAL"],
"apifyProxyCountry":"SA"
}
}

Set apifyProxyCountry to match your target country code (e.g., "JO", "AE", "EG") for best results.

Data Export

• JSON -- structured data for programmatic use
• CSV -- flat tables for spreadsheets and BI tools
• Excel -- direct download from Apify Console
• API -- stream results directly into your pipeline

Automation

• Scheduled runs -- set daily, weekly, or custom schedules in Apify Console
• Webhooks -- get notified when a run completes
• API triggers -- start runs programmatically from your application
• Integrations -- connect to Google Sheets, Slack, Zapier, and more through Apify integrations

Combine it with more data sources

For Saudi Arabia specifically, combine OpenSooq data with the /zen-studio/haraj-scraper or the /zen-studio/mahally-scraper for commerical products with seller contacts.

FAQ

What data does the OpenSooq Scraper extract? 55 fields per listing: title, price, location (city + neighborhood), category hierarchy, seller details (name, rating, verification), phone number (masked), structured attributes (make, model, year, bedrooms, area, etc.), AI-generated tags, media flags, listing status, dates, and more. Enable fetchDetails for full description text and all gallery images.

Do I need an OpenSooq account? No. The scraper handles authentication automatically. No login, no cookies, no browser required.

How many listings can I scrape? Up to 50,000 per run. Pagination is handled automatically.

Which countries are supported? All 20 OpenSooq markets: Jordan, Saudi Arabia, UAE, Kuwait, Bahrain, Oman, Qatar, Iraq, Egypt, Yemen, Libya, Sudan, Lebanon, Palestine, Syria, Algeria, Morocco, Tunisia, Turkey, and Mauritania.

What are the highlights and aiTags fields? highlights contains structured key-value attributes specific to the listing's category -- for cars: make, model, year, mileage, transmission; for real estate: bedrooms, bathrooms, floor area, furnished status. aiTags are OpenSooq's own AI-generated classification labels like brand, condition, listing type, and features.

Are phone numbers fully visible? Phone numbers are masked by OpenSooq (last 2 digits hidden, e.g., 07956790XX). The phoneRevealKey field is included for reference but the full number requires authenticated access on the OpenSooq platform.

What does fetchDetails do? When enabled, the scraper visits each listing's detail page to extract the full untruncated description and all gallery image URLs at full resolution (2000px). This makes the run slower but provides the most complete data.

How fast is it? Approximately 5,000 listings per minute without detail enrichment. With fetchDetails enabled, approximately 1,000 listings per minute due to individual page fetches.

Can I filter by specific attributes like car make or number of bedrooms? The search query and category/city/price filters are supported as input parameters. For attribute-specific filtering (e.g., "only BMW" or "3+ bedrooms"), use the search query to narrow results, then filter the output data using the structured highlights field.

Is the data returned in Arabic or English? Listing content (titles, descriptions) is in whatever language the seller used -- typically Arabic for most MENA markets. Field names, category labels, and city names are in English.

Getting Started

1. Open the Actor in Apify Console
2. Select a country from the dropdown (default: Saudi Arabia)
3. Enter a search query or leave empty to browse all listings
4. Set filters -- city, category, price range, images only
5. Set maximum results (default: 100)
6. Click Start and download results in JSON, CSV, or Excel

Disclaimer

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

Start Scraping OpenSooq Listings Now

Structured MENA marketplace data for research, analytics, and business intelligence.