Name: NoBroker Search – Find Rental Properties | Free · $9/mo | API.market
Brand: the-api-guy
SKU: api-the-api-guy-nobroker-api
Availability: InStock
Rating: 5.00 (1 reviews)
Author: API Market

The API guy

# 🏡 Unofficial NoBroker Property Search API (India)

> **Disclaimer:** This is a **unofficial integration**.
> The API is **not affiliated with or endorsed by NoBroker**. Use it at your own risk and always respect NoBroker’s public-site Terms of Use.

---

## Overview

The 🏡 **Unofficial NoBroker Property Search API** lets Indian developers pull live rental listings and locality data from **NoBroker** without writing brittle web scrapers.
The same REST interface can optionally fetch data from **MagicBricks**, but the primary draw is hassle-free NoBroker access for prop-tech apps, relocation services, and real-estate analytics tools.

---

## Features

* **NoBroker & MagicBricks coverage** from a single endpoint set.
* **Coordinate or locality-ID search** for flexible geo targeting.
* **Automatic geo-boxing** to minimise over-fetching.
* **Parallel locality crawling** returns hundreds of listings in seconds.
* **Unified `Property` schema**—process results once, regardless of source.
* **Built-in health & metrics** (`/health` endpoint).
* **Smart rate limiting** to stay below upstream throttles.

---

## Use Cases

| Use Case                            | Value                                                                |
| ----------------------------------- | -------------------------------------------------------------------- |
| **Indian real-estate portals**      | Embed fresh NoBroker listings without scraping.                      |
| **Relocation & PG apps**            | Show flats near tech campuses in Bengaluru, Pune, Hyderabad, Mumbai. |
| **Rental yield dashboards**         | Compute price-per-sq ft trends with live NoBroker rent data.         |
| **Loan underwriting tools**         | Rapidly validate market rent for buy-to-let mortgages.               |
| **Neighbourhood discovery widgets** | Suggest nearby localities from a user’s GPS coordinate.              |

---

## Pricing

* **1 API unit = 1 property record returned**.
* `GET /health` and `GET /` are free.
* Tiered plans scale from hobby to enterprise ingestion.

---

## Quick Reference

| Method & Path                         | Purpose                            |
| ------------------------------------- | ---------------------------------- |
| **GET `/`**                           | API info (routes, version)         |
| **GET `/health`**                     | Server status & uptime             |
| **GET `/api/nobroker/localities`**    | Nearby localities (NoBroker)       |
| **GET `/api/nobroker/properties`**    | Rental listings (NoBroker)         |
| **GET `/api/magicbricks/localities`** | Localities (MagicBricks, optional) |
| **GET `/api/magicbricks/properties`** | Listings (MagicBricks, optional)   |

---

## Base URL

```
https://prod.api.market/api/v1/the-api-guy/nobroker-api
```

### Authentication

```
x-magicapi-key: YOUR_API_MARKET_KEY
```

---

## Endpoint Details

### 1. GET `/api/nobroker/localities`

Retrieve nearby localities around a coordinate or locality ID.

| Query Param       | Required | Example                     | Notes                                 |
| ----------------- | -------- | --------------------------- | ------------------------------------- |
| `lat_long`        | ✓        | `12.9716,77.5946`           | GPS lat,long **or** NoBroker place ID |
| `distance_km`     |          | `15`                        | 1-50 (default 10)                     |
| `geo_limit_box`   |          | `{"north_east_lat":13.1,…}` | Custom bounding box                   |
| `recursion_level` |          | `3`                         | 1-5 (default 3)                       |

```bash
curl -G "$BASE/api/nobroker/localities" \
     -H "x-magicapi-key: $KEY" \
     --data-urlencode "lat_long=12.9716,77.5946" \
     --data-urlencode "distance_km=15"
```

---

### 2. GET `/api/nobroker/properties`

Fetch live NoBroker rental listings.

Send either a `localities` JSON array or allow auto-discovery via `lat_long`.

```bash
curl -G "$BASE/api/nobroker/properties" \
     -H "x-magicapi-key: $KEY" \
     --data-urlencode 'localities=[{"placeName":"Koramangala","placeId":"123"}]'
```

Response fields (sample):

| Field          | Example                                   |
| -------------- | ----------------------------------------- |
| `title`        | `2 BHK Apartment for Rent in Koramangala` |
| `price`        | `25000`                                   |
| `propertySize` | `1200` (sq ft)                            |
| `deposit`      | `100000`                                  |
| `postedOn`     | `2025-06-20`                              |
| `siteName`     | `NoBroker`                                |
| `fullUrl`      | `https://www.nobroker.in/property/123456` |

---

### 3–4. MagicBricks Endpoints (Optional)

Require `city_name` plus the same geo parameters; schema identical to NoBroker.

---

## Status Codes & Error Handling

| Code | Meaning                              | Fix                     |
| ---- | ------------------------------------ | ----------------------- |
| 200  | Success                              | —                       |
| 400  | Bad query (e.g., missing `lat_long`) | Correct parameters      |
| 401  | Invalid API key                      | Check header            |
| 429  | Rate limit hit                       | Wait `Retry-After` secs |
| 500  | Upstream/site error                  | Retry with back-off     |

Sample **400**:

```json
{
  "success": false,
  "error": "Invalid parameter",
  "message": "lat_long parameter is required",
  "requestId": "7c551ccf-4b99-4fcd-89aa-0b3b4fc90e21"
}
```

---

## Code Samples

### JavaScript

```javascript
import fetch from "node-fetch";
const KEY  = process.env.MAGICAPI_KEY;
const BASE = "https://prod.api.market/api/v1/the-api-guy/nobroker-api";

async function getBangaloreRents() {
  const url = `${BASE}/api/nobroker/properties?lat_long=12.9716,77.5946&distance_km=10`;
  const res = await fetch(url, { headers: { "x-magicapi-key": KEY } });
  const json = await res.json();
  console.log("Total props:", json.data.totalProperties);
}
getBangaloreRents();
```

### Python

```python
import requests, pprint, os

KEY  = os.getenv("MAGICAPI_KEY")
BASE = "https://prod.api.market/api/v1/the-api-guy/nobroker-api"

r = requests.get(f"{BASE}/api/nobroker/properties",
                 headers={"x-magicapi-key": KEY},
                 params={"lat_long": "12.9716,77.5946", "distance_km": 10},
                 timeout=30)
r.raise_for_status()
pprint.pprint(r.json()["data"]["allProperties"][:3])
```

### cURL

```bash
curl -G "$BASE/api/nobroker/properties" \
     -H "x-magicapi-key: YOUR_API_MARKET_KEY" \
     --data-urlencode "lat_long=28.6139,77.2090" \
     --data-urlencode "distance_km=8"
```

---

## Rate Limits

This unofficial service applies adaptive throttling. If you receive **429 Too Many Requests**, pause for the `Retry-After` header duration before retrying.

---

## FAQ

**Is this API endorsed by NoBroker?**
No. It’s an independent interface built on publicly-available data.

**Can I store the data?**
Short-term caching is fine; long-term storage must respect NoBroker’s site terms.

**Which Indian cities are supported?**
All locations listed on NoBroker: Bengaluru, Mumbai, Delhi-NCR, Pune, Hyderabad, Chennai, Kolkata, etc.

**How often should I poll?**
For locality discovery, you can cache results for hours. For listings, polling every 30–60 minutes is typical.

---

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello\[at]api.market.


Search rental & resale properties on NoBroker & MagicBricks. Free 10 calls/mo, from $9/mo. Start free on API.market.

NoBroker Search – Find Rental Properties | Free · $9/mo | API.market

Free

Ultra

Mega

The API has 100% uptime and works flawlessly