# Dubizzle Egypt — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse real estate listings and classifieds from Dubizzle Egypt, view detailed property information, explore available categories and locations, and discover featured agencies with their complete listings. Filter properties by various criteria and access comprehensive data on homes, apartments, and other classified items across Egypt.

**Category:** Real Estate | **Website:** [dubizzle.com.eg/](https://dubizzle.com.eg/) | **Docs:** [parse.bot/marketplace/0223888a-1b36-4e8e-ab96-af0dd4590e6c/dubizzle-com-eg-api](https://parse.bot/marketplace/0223888a-1b36-4e8e-ab96-af0dd4590e6c/dubizzle-com-eg-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-dubizzle-com-eg-api-0223888a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_agency_listings

Get all listings from a specific agency. Returns paginated results sorted by newest first. The agency_id comes from get_featured_agencies results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `agency_id` | string | Yes | The agency's external ID from get_featured_agencies results (e.g. '128') |
| `limit` | integer | No | Results per page |
| `page` | integer | No | Page number |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dubizzle-com-eg-api-0223888a/get_agency_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agency_id":"<string>","limit":"<integer>","page":"<integer>"}'
```

### get_featured_agencies

Get a list of top real estate agencies sorted by number of listings descending. Returns up to 50 agencies with their listing counts and agent counts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dubizzle-com-eg-api-0223888a/get_featured_agencies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_locations

Search for locations in Egypt. Returns matching locations sorted by level then name. If no query provided, returns all top-level locations. Location slugs can be used in search_properties.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search query for location name (case-insensitive partial match, e.g. 'cairo') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dubizzle-com-eg-api-0223888a/get_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_property_categories

List available categories across all classifieds with listing counts. Returns categories sorted by listing count descending. Useful for discovering valid category slugs for search_properties.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dubizzle-com-eg-api-0223888a/get_property_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_property_detail

Get full details of a property by its ID. Returns comprehensive listing information including photos, amenities, seller info, and location hierarchy. The ad_id is the external listing ID visible in listing URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ad_id` | string | Yes | The property/ad external ID (e.g. '503623685') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dubizzle-com-eg-api-0223888a/get_property_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ad_id":"<string>"}'
```

### get_property_filters

Get available filter options and counts for a property category. Useful for discovering valid filter values (bedrooms, bathrooms, ownership, types, completion_status) before searching.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug to get filters for (e.g. 'properties', 'apartments-duplex-for-sale') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dubizzle-com-eg-api-0223888a/get_property_filters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### search_all_classifieds

General keyword search across all classifieds (not limited to properties). Searches across all indexed fields including title, description, category, and metadata using wildcard matching. Results are sorted by relevance score when a query is provided, or by newest when omitted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page |
| `page` | integer | No | Page number |
| `query` | string | No | Search keyword (e.g. 'iphone', 'toyota', 'samsung'). Searches across all fields. Omitting returns all listings sorted by newest. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dubizzle-com-eg-api-0223888a/search_all_classifieds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

### search_properties

Search for property listings with various filters. Returns paginated results sorted by newest listing by default. Supports filtering by location, category, price range, bedrooms, bathrooms, and area. Each result includes full listing details with photos, seller info, and amenities.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area_max` | integer | No | Maximum area in sqm |
| `area_min` | integer | No | Minimum area in sqm |
| `bathrooms` | string | No | Number of bathrooms (e.g. '1', '2', '3') |
| `bedrooms` | string | No | Number of bedrooms (e.g. '1', '2', '3') |
| `category` | string | No | Category slug (e.g. 'apartments-duplex-for-sale', 'villas-for-sale'). Defaults to 'properties'. |
| `limit` | integer | No | Results per page |
| `location` | string | No | Location slug to filter by (e.g. 'cairo', 'new-cairo') |
| `page` | integer | No | Page number |
| `price_max` | integer | No | Maximum price in EGP |
| `price_min` | integer | No | Minimum price in EGP |
| `sort` | string | No | Sort order for results |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dubizzle-com-eg-api-0223888a/search_properties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_max":"<integer>","area_min":"<integer>","bathrooms":"<string>","bedrooms":"<string>","category":"<string>","limit":"<integer>","location":"<string>","page":"<integer>","price_max":"<integer>","price_min":"<integer>","sort":"<string>"}'
```