Magicbricks APImagicbricks.com ↗
Access Magicbricks property listings, new projects, and locality price trends across major Indian cities via 5 structured API endpoints.
What is the Magicbricks API?
The Magicbricks API provides 5 endpoints covering residential and commercial property listings, new development projects, 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, BHK configuration, and property type — filterable by city, locality, budget range, and category (sale or rent).
curl -X GET 'https://api.parse.bot/scraper/b445a4e1-5a2a-43db-bfc0-334e2b50b854/search_properties?bhk=2&city=Noida&page=1&category=S&locality=Sector+128&budget_max=50000000&budget_min=1000000&property_type=Flat' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| Param | Type | Description |
|---|---|---|
| bhk | string | 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. |
| cityrequired | string | City name. Accepted 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": "84916571",
"lt": 86524,
"bathD": "5",
"price": 39912000,
"caSqFt": 2950,
"ctName": "Noida",
"priceD": "3.99 Cr",
"devName": "Jaypee Greens",
"prjname": "Jaypee Greens Knights Court",
"bedroomD": "4",
"lmtDName": "Sector 128, Noida Express Way",
"propTypeD": "Apartment",
"furnishedD": "Unfurnished",
"ltcoordGeo": "28.5259509261874,77.3615789006735",
"possStatusD": "Ready To Move",
"propertyTitle": "4BHK Multistorey Apartment for New Property in Jaypee Greens Knights Court at Sector 128, Noida Express Way",
"transactionTypeD": "New Property"
}
],
"editAdditionalDataBean": {
"pageCount": "50",
"resultCount": 1500
}
},
"status": "success"
}
}About the Magicbricks API
Property Search and Filtering
The search_properties endpoint is the core of the API. It accepts a required city parameter — covering Noida, Pune, Bangalore, Mumbai, Gurgaon, Hyderabad, Chennai, Kolkata, and others — along with optional filters for bhk, property_type (Flat, House/Villa, Plot, Multistorey Apartment, Builder Floor, Penthouse), budget_min/budget_max in INR, locality, and category (S for sale, R for rent). Each page returns 30 results in a resultList array, where each object includes price, geographic coordinates, images, and property features. Pagination and active filter metadata come back in editAdditionalDataBean.
For geo-anchored searches, search_properties_by_latlng accepts a latitude/longitude pair and an optional radius_m (100–50,000 metres), removing the need to specify a city. Results follow the same shape as search_properties, with coordinates stored as pmtLat/pmtLong on each listing object and result count exposed in editAdditionalDataBean.resultCount.
Commercial Properties and New Projects
search_commercial_properties targets offices, shops, showrooms, and warehouses, accepting the same city, page, and category parameters as the residential endpoint. The response mirrors the resultList / editAdditionalDataBean structure. Note that commercial inventory availability varies by city, and some markets may return limited results.
search_new_projects focuses on under-construction and recently launched residential developments. Each object in projectsCards includes the project name, builder/developer, price range, BHK options, possession timeline, RERA status, and amenities. The endpoint paginates at 20 projects per page, with total page count in pageCount.
Locality Price Trends
get_locality_rates returns 12 months of average price-per-sqft data for a given locality and its nearby areas. The locality_id is a numeric string found as the lt or loc field on individual listings from search_properties. Response fields include monthwiseData (monthly price arrays keyed by locality ID), localitiesDescMap (ID-to-name mapping), monthYrAvgPriceStr (the 12-month axis labels), and currentPricesNearbyMap (current per-sqft averages for surrounding localities).
The Magicbricks API is a managed, monitored endpoint for magicbricks.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when magicbricks.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official magicbricks.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a property price comparison tool tracking 12-month per-sqft trends across multiple Bangalore or Mumbai localities using get_locality_rates.
- Aggregate new project listings by builder to evaluate developer activity in a city using search_new_projects projectsCards data.
- Find all 3BHK apartments for rent within 5 km of a specific office campus using search_properties_by_latlng with a radius_m filter.
- Generate a map of commercial office listings available for sale in Hyderabad using search_commercial_properties with category S.
- Notify users when new listings appear in a target locality and budget range by polling search_properties with locality and budget_min/budget_max filters.
- Display possession timelines and RERA status for new residential projects to help buyers assess development risk from search_new_projects.
- Cross-reference listing coordinates from search_properties with transit or school datasets using pmtLat/pmtLong fields.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.