# Magicbricks — 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 residential and commercial property listings, new development projects, and locality price trends across major Indian cities on Magicbricks.

**Category:** Real Estate | **Website:** [magicbricks.com/](https://magicbricks.com/) | **Docs:** [parse.bot/marketplace/e8061f2d-31b3-4f5a-bb4f-545606772fac/magicbricks-com-api](https://parse.bot/marketplace/e8061f2d-31b3-4f5a-bb4f-545606772fac/magicbricks-com-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-magicbricks-com-api-e8061f2d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_locality_rates

Get property price rates and market trends for a specific locality. Returns monthly price data per sqft for the locality and nearby areas over the last 12 months. The locality_id can be found in search_properties results as the 'lt' or 'loc' field on each property listing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name. |
| `locality_id` | string | Yes | Locality ID (numeric string found in search_properties results as the 'lt' or 'loc' field). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-magicbricks-com-api-e8061f2d/get_locality_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","locality_id":"<string>"}'
```

### search_commercial_properties

Search for commercial properties (offices, shops, showrooms, warehouses) for sale or rent. Returns paginated results with 30 listings per page. Response structure matches search_properties with resultList and editAdditionalDataBean. Some cities may have limited commercial inventory.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category: 'S' for Sale, 'R' for Rent. |
| `city` | string | Yes | City name. Accepted values: 'Noida', 'Pune', 'Bangalore', 'Mumbai', 'Gurgaon', 'Hyderabad', 'Chennai', 'Kolkata', 'Ahmedabad', 'Thane'. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-magicbricks-com-api-e8061f2d/search_commercial_properties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","city":"<string>","page":"<integer>"}'
```

### search_new_projects

Search for new residential projects in a city. Returns project names, builder names, price ranges, amenities, RERA status, and expert review videos. Paginated with 20 projects per page. Each project card includes developer info, location, BHK options, and possession timeline.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name. Accepted values: 'Noida', 'Pune', 'Bangalore', 'Mumbai', 'Gurgaon', 'Hyderabad', 'Chennai', 'Kolkata', 'Ahmedabad', 'Thane'. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-magicbricks-com-api-e8061f2d/search_new_projects \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","page":"<integer>"}'
```

### search_properties

Search for residential properties for sale or rent in Indian cities. Returns detailed listings with price, location, coordinates, and property features. Results are paginated with 30 listings per page. Filtering by BHK, property type, budget range, and locality is supported. The response includes both a resultList array and metadata in editAdditionalDataBean with pagination info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bhk` | string | No | BHK configuration as comma-separated values. Accepted single values: '1', '2', '3', '4', '5'. Combinations are supported like '2,3' for 2 and 3 BHK together. |
| `budget_max` | integer | No | Maximum budget in INR. |
| `budget_min` | integer | No | Minimum budget in INR. |
| `category` | string | No | Category: 'S' for Sale, 'R' for Rent. |
| `city` | string | Yes | City name. Accepted values: 'Noida', 'Pune', 'Bangalore', 'Mumbai', 'Gurgaon', 'Hyderabad', 'Chennai', 'Kolkata', 'Ahmedabad', 'Thane'. |
| `locality` | string | No | Locality name to filter results within the city. |
| `page` | integer | No | Page number for pagination. |
| `property_type` | string | No | Property type. Accepted values: 'Flat', 'House/Villa', 'Plot', 'Multistorey Apartment', 'Builder Floor', 'Penthouse', 'Studio Apartment', 'Residential House', 'Villa', 'Residential Plot'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-magicbricks-com-api-e8061f2d/search_properties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bhk":"<string>","budget_max":"<integer>","budget_min":"<integer>","category":"<string>","city":"<string>","locality":"<string>","page":"<integer>","property_type":"<string>"}'
```