magicbricks.com APImagicbricks.com ↗
Access Magicbricks property listings, new projects, commercial spaces, and locality price trends across major Indian cities via a structured API.
curl -X GET 'https://api.parse.bot/scraper/b445a4e1-5a2a-43db-bfc0-334e2b50b854/search_properties?city=Mumbai' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for residential properties for sale or rent. Returns detailed listings with price, location, coordinates, and property features. Results are paginated with 30 listings per page.
| Param | Type | Description |
|---|---|---|
| bhk | string | BHK configuration as comma-separated values. Accepted values: '1', '2', '3', '4', '5', or combinations like '2,3'. |
| cityrequired | string | City name. Confirmed working values: 'Noida', 'Pune', 'Bangalore', 'Mumbai', 'Gurgaon', 'Hyderabad', 'Chennai', 'Kolkata', 'Ahmedabad', 'Thane'. |
| page | integer | Page number for pagination. |
| category | string | Category: 'S' for Sale, 'R' for Rent. |
| locality | string | Locality name to filter results within the city. |
| budget_max | integer | Maximum budget in INR. |
| budget_min | integer | Minimum budget in INR. |
| property_type | string | Property type. Accepted values: 'Flat', 'House/Villa', 'Plot', 'Multistorey Apartment', 'Builder Floor', 'Penthouse', 'Studio Apartment', 'Residential House', 'Villa', 'Residential Plot'. |
{
"type": "object",
"fields": {
"resultList": "array of property listing objects with price, location, coordinates, images, and features",
"editAdditionalDataBean": "object containing search metadata, pagination info, and filter options"
},
"sample": {
"data": {
"resultList": [
{
"id": "83871309",
"price": 13500000,
"caSqFt": 1510,
"ctName": "Noida",
"priceD": "1.35 Cr",
"prjname": "Panchsheel Greens",
"bedroomD": "3 BHK",
"lmtDName": "Noida Extension",
"ltcoordGeo": "28.615887848111,77.4262748642862",
"possStatusD": "Ready to Move",
"propertyTitle": "3 BHK Multistorey Apartment for Sale in Noida Extension"
}
],
"editAdditionalDataBean": {
"pageCount": "5",
"resultCount": 150
}
},
"status": "success"
}
}About the magicbricks.com API
The Magicbricks API provides 4 endpoints covering residential listings, new development projects, commercial properties, and locality-level price trends across major Indian cities. The search_properties endpoint returns up to 30 paginated listings per page with price, GPS coordinates, images, and property features. The get_locality_rates endpoint delivers 12 months of monthly average price-per-sqft data for a target locality and its neighbors.
Residential and Commercial Property Search
The search_properties endpoint accepts a required city parameter — confirmed working for Noida, Pune, Bangalore, Mumbai, Gurgaon, Hyderabad, and Chennai — plus optional filters for bhk, category (Sale or Rent), property_type, locality, and budget_min/budget_max in INR. Each listing in the resultList array includes price, location details, GPS coordinates, images, and property features. The editAdditionalDataBean object in the response carries pagination info and available filter options. The search_commercial_properties endpoint follows the same city-and-category structure but returns offices, shops, showrooms, and warehouses instead of residential units.
New Projects
search_new_projects returns 20 projects per page for a given city. Each entry in projectsCards includes the project name, developer/builder name, price range, amenities list, RERA status, and expert review video data. The pageCount and cardsCount fields at the top level give you the total pages available and the count of results on the current page, so pagination can be implemented without guessing.
Locality Price Trends
get_locality_rates requires a city and a locality_id — the numeric string found in the lt or loc field on individual listings from search_properties. The response includes monthwiseData, which maps locality IDs to arrays of 12 monthly average price-per-sqft values, and localitiesDescMap, which maps those same IDs to human-readable locality names. The monthYrAvgPriceStr field provides comma-separated month-year labels aligned to the data arrays. The currentPricesNearbyMap array lists nearby localities with their current average price per sqft, useful for comparable market analysis.
- Build a rental budget estimator using
search_propertiesfiltered bycategory: R,city, andbudget_max. - Aggregate new project launches by city using
search_new_projectsto track builder activity and RERA compliance status. - Plot 12-month price-per-sqft trends for a target locality using
monthwiseDatafromget_locality_rates. - Compare commercial office and retail availability across cities using
search_commercial_propertieswithcategory: Sorcategory: R. - Generate neighborhood price heat maps by cross-referencing
currentPricesNearbyMapentries across multiple locality IDs. - Filter BHK-specific listings in a locality to track how per-unit pricing changes by configuration using the
bhkparameter. - Monitor developer pipeline in a specific city by paginating through
search_new_projectsand recording new entries over time.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Magicbricks have an official public developer API?+
How do I retrieve locality-level price trend data and what IDs do I need?+
get_locality_rates with a city and a locality_id. The locality ID is the numeric string returned in the lt or loc field on individual listing objects from search_properties. Once you have an ID, the response gives you monthwiseData (12 monthly price-per-sqft averages), localitiesDescMap (ID-to-name mapping), and currentPricesNearbyMap (nearby locality current prices).Does the API cover property detail pages or individual listing data beyond what appears in search results?+
resultList — price, location, coordinates, images, and features — as aggregated in search result pages. Individual property detail pages with full amenity breakdowns, floor plans, or contact information are not covered. You can fork this API on Parse and revise it to add a property detail endpoint.Is the API limited to specific cities, or does it cover all Indian cities on Magicbricks?+
What is the pagination behavior across endpoints?+
search_properties and search_commercial_properties return 30 listings per page; use the page integer parameter to advance. search_new_projects returns 20 projects per page with an explicit pageCount field in the response to tell you the total number of pages. get_locality_rates does not paginate — it always returns the full 12-month series for the requested locality.