dubizzle.com.eg APIdubizzle.com.eg ↗
Access property listings, classifieds, agencies, and location data from Dubizzle Egypt (OLX Egypt) via 8 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/c387c7a6-02cc-45c8-8c3c-1ad385542b86/search_properties?limit=2&bedrooms=3&category=apartments-duplex-for-sale' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for property listings with various filters. Returns paginated results sorted by newest listing by default.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number |
| sort | string | Sort order: 'newly_listed', 'price_asc', 'price_desc' |
| limit | integer | Results per page |
| area_max | integer | Maximum area in sqm |
| area_min | integer | Minimum area in sqm |
| bedrooms | string | Number of bedrooms (e.g. '1', '2', '3') |
| category | string | Category slug (e.g. 'apartments-duplex-for-sale', 'villas-for-sale'). Defaults to 'properties'. |
| location | string | Location slug to filter by (e.g. 'cairo', 'new-cairo') |
| bathrooms | string | Number of bathrooms (e.g. '1', '2', '3') |
| price_max | integer | Maximum price in EGP |
| price_min | integer | Minimum price in EGP |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"items": "array of property listing objects",
"total": "integer, total number of matching results"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"id": "503513515",
"url": "https://www.dubizzle.com.eg/en/ad/prime-located-twin-house-ready-to-move-in-patio-zahraa-next-to-al-rabwa-ID503513515.html",
"area": 275,
"price": 9500000,
"title": "Prime located Twin house ready to move in Patio Zahraa next to Al Rabwa",
"bedrooms": "4",
"category": "Villas For Sale",
"currency": "EGP",
"location": [
{
"name": "Egypt",
"slug": "egypt",
"level": 0
},
{
"name": "Giza",
"slug": "giza",
"level": 1
}
],
"bathrooms": "4"
}
],
"total": 10000
},
"status": "success"
}
}About the dubizzle.com.eg API
The Dubizzle Egypt API provides access to real estate listings and general classifieds from dubizzle.com.eg across 8 endpoints. You can search properties with filters for bedrooms, area, price, and location using search_properties, retrieve full listing details including photos and seller info via get_property_detail, and explore agencies, categories, and Egypt's location hierarchy — all returned as structured JSON.
Property Search and Listing Detail
The search_properties endpoint accepts filters including category (e.g. apartments-duplex-for-sale, villas-for-sale), location (a slug from get_locations), bedrooms, area_min, area_max, and sort order (newly_listed, price_asc, price_desc). Results are paginated with page, total, and an items array. For a full listing, get_property_detail takes an ad_id and returns fields including price, area, currency (always EGP), photos (with url_800x600 and url_400x300 variants), bedrooms, category, and a seller object containing name, agency_name, and agency_id.
Categories, Filters, and Locations
get_property_categories returns all classifieds categories with their slug and active listing count, which you can pass directly into search_properties. Before searching, get_property_filters lets you introspect valid filter values for a given category — it returns arrays for types, bedrooms, bathrooms, ownership (e.g. resale, primary), and completion_status, each with value and count. Location slugs come from get_locations, which supports partial-match query strings and returns a hierarchy from country (level 0) down to compound (level 4).
Agencies and General Classifieds
get_featured_agencies returns up to 50 real estate agencies sorted by ads_count, with fields for id, name, logo, agents_count, and product tier. Pass an agency's id into get_agency_listings to retrieve that agency's full paginated inventory. For non-property searches, search_all_classifieds accepts a free-text query and searches across all classified fields — title, description, category — returning results sorted by relevance score.
- Build a property price tracker for Cairo apartments by polling search_properties with price_asc sort and storing EGP price fields over time.
- Aggregate agency performance dashboards using ads_count and agents_count from get_featured_agencies alongside their listings via get_agency_listings.
- Generate location-aware property alerts by combining get_locations hierarchy data with search_properties filters for specific governorates or compounds.
- Populate a property comparison tool using get_property_detail photo arrays, area, bedrooms, and seller info for multiple ad IDs.
- Discover valid filter options before presenting a search UI by calling get_property_filters for a given category slug.
- Search cross-category classifieds (electronics, cars, etc.) using search_all_classifieds with keyword queries like 'iphone' or 'toyota'.
- Map Egypt's property listing density by location level using get_locations combined with category counts from get_property_categories.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Dubizzle Egypt have an official developer API?+
What does get_property_detail return beyond basic listing info?+
photos array with two image size variants (url_800x600 and url_400x300), a seller object with name, agency_name, and agency_id, plus area in sqm, bedrooms, category, price, and currency (always EGP). The url field gives the canonical link back to the original listing.How granular is the location data returned by get_locations?+
level field ranging from 0 (country) through 4 (compound). A query like cairo will return matching entries at multiple hierarchy levels — governorate, city, and sub-area — each with a slug ready for use in search_properties.Does the API expose property description text or amenity lists?+
get_property_detail cover price, area, bedrooms, photos, seller, category, and title, but do not include a free-text description field or a structured amenities list. You can fork this API on Parse and revise it to add those fields if they are accessible from the source listing.Can I filter search_properties by price range?+
search_properties endpoint supports sorting by price_asc and price_desc but does not currently expose price_min or price_max filter parameters. You can fork this API on Parse and revise it to add price-range filtering.