# Dubizzle Egypt — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/dubizzle-egypt/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/dubizzle-egypt/get-agency-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dubizzle-egypt/get-featured-agencies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dubizzle-egypt/get-locations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dubizzle-egypt/get-property-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dubizzle-egypt/get-property-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dubizzle-egypt/get-property-filters \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dubizzle-egypt/search-all-classifieds \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/dubizzle-egypt/search-properties \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.