# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/magicbricks/`
**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 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/credits/magicbricks/get-locality-rates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/magicbricks/search-commercial-properties \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/magicbricks/search-new-projects \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/magicbricks/search-properties \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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>"}'
```

## Next steps

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