Magicbricks (India) API & Scraper
The Magicbricks API returns India property listings for sale and rent from magicbricks.com as JSON, with prices in rupees as integers, plus new projects with their RERA documents, agents, paying-guest homes and locality price trends.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
It reads the site logged out. `search` takes a city, as a name in any common spelling (Mumbai or Bombay, Bangalore or Bengaluru, Gurgaon or Gurugram, New Delhi or Delhi) or the site's city id, optional localities and every filter the site's own form offers (budget, BHK, property type, area, furnishing, possession, availability, sale type, posted since, posted by owner / agent / builder, ownership, age, bathrooms, facing, floor, amenities, verified, RERA, offers, and the commercial filters for cabins, pantry, parking and pre-leased), 30 rows a page and up to 100 pages. On 2026-11-15 Mumbai had 64,165 listings for sale and 32,221 for rent; Bangalore 79,100 and 44,060. Each row carries the price and price per sq.ft, BHK, carpet and covered area, floor, facing, possession, locality with coordinates, the project and its developer with RERA numbers, amenities, nearby places, photos and the lister: owner, agent or builder with name and company. `property` opens one listing in full with the site's market estimate, EMI, price breakup (deposit, brokerage, first-month total on rentals), the project block and the lister's track record. Phone numbers and e-mail addresses are not returned: Magicbricks shows them only to visitors who log in, and the listing page's masked number comes back as phone_masked. `projects`, `project`, `project_reviews` and `project_rera` cover new projects down to their RERA certificates; `agents` and `agent` cover the site's agents; `locality_trends` returns 5 years of quarterly ₹/sq.ft for a locality; `pg_search` and `pg` cover paying-guest homes.
What a Magicbricks field actually contains
Fields that read differently from how they look. Every row was measured against live magicbricks.com data on 2026-11-15.
| Field | What it holds |
|---|---|
| city | A city name in any common spelling or the site's city id, on every action that takes a city. On 2026-11-16 Mumbai / mumbai / 4320, Bengaluru / bangalore / 3327, Gurugram / GURGAON / 2951 and Delhi / New Delhi / 2624 returned the same rows on 27 of 27 comparisons across 7 actions. The site's live total can move by up to 0.1% between two calls of the same search. |
| price_inr | The listing's price line in whole rupees. On a sale it is the line the page labels "Total Price"; on a rental it is the line labelled "Rent", i.e. the monthly rent. price_label returns that label. 15 of 15 listings opened from a search row carried the same price, and 120 of 120 rows matched their printed price ("2.25 Cr", "28 Lac"). |
| security_deposit_inr vs booking_amount_inr | One source field, named by transaction: on rentals it is the security deposit and equals the deposit line of the listing's price breakup (8 of 8 Bangalore rentals); on sales it is the booking amount. The other one is null. |
| price_breakup (property) | The listing's price breakup box: monthly rent, security deposit, brokerage and its terms, first-month total on rentals; total, resale or all-inclusive price, extra charges and the site's price estimate on sales. Keys are only present when the site fills them. |
| property_type filter | Magicbricks filters by its own groups: flat (apartment, builder floor, penthouse, studio), house_villa, plot, office, shop_showroom, commercial_land, warehouse, industrial_building, industrial_shed, coworking, agricultural_land, farm_house. Asking for apartment or villa returns the whole group (Mumbai flats 59,210 either way); each row's property_type names the exact type. |
| page and total_pages | 30 rows a page. The site serves 100 pages (3,000 rows) per search; beyond that it would repeat page 1, so page 101 is refused. total is the site's own count of all matches (Mumbai sale 64,165); narrow the search with filters or localities to reach every listing. |
| meta.source_sort | The order Magicbricks applied. The default order of sale searches is the site's own ranking and can differ by visitor; the explicit sorts (newest, price, price per sq.ft) are deterministic. |
| lister | Who posted the listing: type (Owner, Agent, Builder), name, company, operating since, RERA registration, rating and listing counts as the site publishes them. Magicbricks shows the phone number and e-mail only after a login, so neither is returned; the masked number the listing page shows (91XXXXXXXX) is returned as phone_masked. |
| possession_by | The site's own 'possession between' filter. It is loose upstream: under-construction homes with possession by 2027 returned 4,251 rows that include Dec '28 dates. |
| agents.card_layout | The site's agent list mixes a full card (about text, deal types, localities served) and a compact card (name, company, counts). Mumbai: 496 agents, 105 full and 391 compact. |
Prices are in Indian rupees as integers. Every listing id taken from a search (15 of 15 on five kinds of search) opened as the same listing with the same price, BHK and locality.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/magicbricks/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"city": "Mumbai",
"bedrooms": "2"
}
}{
"ok": true,
"meta": {
"api": "magicbricks",
"endpoint": "search",
"mode": "live",
"latency_ms": 1581.2,
"record_count": 30,
"bytes": 415202,
"cache_hit": false,
"upstream_requests": 1,
"total": 21600,
"has_next": true,
"filters_applied": {
"transaction": "buy",
"city": "Mumbai",
"bedrooms": [
"2"
],
"sort": "relevance"
},
"source_sort": "nriSort",
"page_ceiling_note": "21600 matches; the site serves the first 3000 (100 pages)",
"charged_credits": 1,
"version": "1.0.0",
"request_id": "9d90848eaa524a93",
"queue_ms": 1.2,
"fetched_at": "2026-11-15T22:38:36.146Z"
},
"data": {
"listings": [
{
"id": "87289139",
"url": "https://www.magicbricks.com/propertyDetails/2-BHK-1000-Sq-ft-Multistorey-Apartment-FOR-Sale-Malad-East-in-Mumbai&id=4d423837323839313339",
"title": "2BHK Multistorey Apartment for Resale in K Raheja Residency at Malad East",
"transaction": "buy",
"transaction_type": "Resale",
"property_type": "Apartment",
"property_type_key": "apartment",
"price_inr": 22500000,
"price_display": "2.25 Cr",
"price_per_sqft_inr": 22500,
"booking_amount_inr": 500000,
"security_deposit_inr": null,
"maintenance_inr": 12000,
"maintenance_frequency": "Monthly",
"brokerage_inr": null,
"offer": null,
"bedrooms": 2,
"bathrooms": 2,
"balconies": null,
"carpet_area": {
"value": 800,
"unit": "Sq-ft"
},
"covered_area": {
"value": 1000,
"unit": "Sq-ft"
},
"plot_area": null,
"covered_area_sqft": 1000,
"furnishing": "Semi-Furnished",
"floor": "28 of 31 Floor",
"floor_number": "28",
"total_floors": 31,
"facing": "West",
"overlooking": "Garden/Park, Pool",
"possession_status": "[redacted-secret]",
"available_from": null,
"construction_age": "New Construction",
"ownership": "Freehold",
"parking": "1 Covered",
"flooring": "Vitrified",
"power_backup": "No/Rare Powercut",
"water_availability": "Water Availability 24 Hours Available",
"additional_rooms": "None of these",
"tenant_preference": "Bachelors/Family",
"in_society": true,
"description": "K Raheja Residencys new towers Towers S T in Malad East offer readypossession homes with Occupancy Certificates OC, saving buyers from paying GST. Low Density Only 2 to 4 premium flats per floor for maximum privacy. Elevator Ratio 4 to 5 highspeed lifts per highrise tower ensure zero wait times. Massive Greenery Uninterrupted, panoramic views of the Aarey Colony forest. Township Perks Access to a huge 20,000 sq. ft. clubhouse and a 2acre podium garden.",
"summary": "This 2 BHK home in Malad East, Mumbai is available for sale. The flat is housed in K Raheja Residency, a 3 years old construction. 1 covered parking space is provided to park your vehicle with this 2 BHK apartment.This ready to move flat located in Malad East is available at the price of ₹2.25 Cr (₹22,500/sqft). The unit is located on 28 floor (28 Out of 31) featuring carpet area 800 sqft. This development has 31 floor and provides Kids play area. The flat contains power back up, reserved parking, security, service/goods lift, air conditioned, visitor parking, intercom facility, ro water syste",
"highlights": [],
"location": {
"locality_id": "60207",
"locality": "Malad East",
"city_id": "4320",
"city": "Mumbai",
"landmark": "Infinity IT Park 0.6km, Oberoi Mall, Aarey Forest views, Dindoshi.",
"address": "Raheja Residency, General Arun Kumar Vaidya Marg, Malad east - Mumbai - 400097",
"latitude": 19.17754,
"longitude": 72.87643
},
"project": {
"id": "5039037",
"name": "K Raheja Residency",
"url": "https://www.magicbricks.com/k-raheja-residency-malad-east-mumbai-pdpid-4d4235303339303337",
"developer": "K. Raheja Realty",
"developer_id": "54098",
"rera": []
},
"amenities": [
"Smart Home",
"Wrap Around Balcony",
"Fireplace"
],
"nearby": [
{
"category": "[trimmed-depth]",
"name": "[trimmed-depth]",
"distance_text": "[trimmed-depth]",
"id": "[trimmed-depth]"
},
{
"category": "[trimmed-depth]",
"name": "[trimmed-depth]",
"distance_text": "[trimmed-depth]",
"id": "[trimmed-depth]"
},
{
"category": "[trimmed-depth]",
"name": "[trimmed-depth]",
"distance_text": "[trimmed-depth]",
"id": "[trimmed-depth]"
}
],
"lister": {
"type": "Agent",
"id": "74987951",
"name": "Nagesh Pujari",
"company": "Nagesh Pujari",
"operating_since": null,
"rera_registration": null,
"rera_registered": null,
"certified": null,
"rating": null,
"buyers_served": null,
"listings_count": null,
"employees": null,
"photo": null,
"profile_url": "https://www.magicbricks.com/property-agent-details/agent-agentid-4d423734393837393531"
},
"images": [],
"cover_image": "https://img.staticmb.com/mbimages/project/Photo_h310_w462/2025/07/21/Project-Photo-11-Raheja-Residency-Mumbai-5039037_1505_2000_310_462.jpg",
"image_count": 38,
"videos": [
"https://www.youtube.com/watch?v=tlZEs9v6uW4"
],
"verified": false,
"rera_registered": null,
"rera_id": null,
"mb_exclusive": null,
"is_project_unit": false,
"nri_preferred": null,
"commercial": null,
"plot": {
"floors_allowed": 1
},
"approved_by": "ABADev",
"gated_community": null,
"legal_documents": [],
"infrastructure": [],
"posted_at": "2026-11-12T23:45:27Z",
"posted_label": "Posted: Nov 13, '26",
"expires_at": "2027-01-11T23:45:27Z"
},
{
"id": "86853059",
"url": "https://www.magicbricks.com/propertyDetails/2-BHK-944-Sq-ft-Multistorey-Apartment-FOR-Sale-Worli-in-Mumbai&id=4d423836383533303539",
"title": "2BHK Multistorey Apartment for New Property in Lodha Adrina at Worli",
"transaction": "buy",
"transaction_type": "New Property",
"property_type": "Apartment",
"property_type_key": "apartment",
"price_inr": 66080000,
"price_display": "6.60 Cr",
"price_per_sqft_inr": 70000,
"booking_amount_inr": 1000000,
"security_deposit_inr": null,
"maintenance_inr": 20,
"maintenance_frequency": "Per sq. Unit Monthly",
"brokerage_inr": null,
"offer": null,
"bedrooms": 2,
"bathrooms": 2,
"balconies": null,
"carpet_area": {
"value": 944,
"unit": "Sq-ft"
},
"covered_area": {
"value": 944,
"unit": "Sq-ft"
},
"plot_area": null,
"covered_area_sqft": 944,
"furnishing": "Unfurnished",
"floor": "35 of 60 Floor",
"floor_number": "35",
"total_floors": 60,
"facing": "East",
"overlooking": "Garden/Park, Main Road",
"possession_status": "[redacted-secret]",
"available_from": null,
"construction_age": "New Construction",
"ownership": "Freehold",
"parking": "1 Covered",
"flooring": "Vitrified",
"power_backup": "No/Rare Powercut",
"water_availability": "Water Availability 24 Hours Available",
"additional_rooms": "Study",
"tenant_preference": "Bachelors/Family",
"in_society": true,
"description": "Fresh air, natural light, and spectacular views for livingPanoramic views of Bandra-Worli Sea Link and Lodha ParkDesigned by WOHA Architects landscape by P Landscape, Bangkok4 hi-speed passenger elevators and 2 service elevators per wingEmergency alarm in each residence4 swimming pools with one covered heated poolHospitality Services by Saint Amand at entire campus",
"summary": "The 2 BHK flat is available for sale in Worli, Mumbai.This flat is situated in Lodha Adrina and is equipped with premium facilities. The 2 BHK flat on sale provides a parking of 1 covered for personal vehicles of the family members. This ready to move flat in Worli can be availed at a price of ₹6.60 Cr (₹70,000/sqft). The unit is located on 35 floor (35 Out of 60) featuring carpet area 944 sqft. The building has 60 floor and contains Kids play area, Kids Club, Kids Splash Pool. The apartment provides power back up, reserved parking, security, visitor parking, intercom facility. The property is",
"highlights": [],
"location": {
"locality_id": "78910",
"locality": "Worli",
"city_id": "4320",
"city": "Mumbai",
"landmark": "Worli",
"address": "Lodha Park Worli Mumbai Pandurang Budhkar Marg Next to Shree Simandhar Swami Jain Temple, Worli",
"latitude": 19.0047256,
"longitude": 72.8302417
},
"project": {
"id": "5403159",
"name": "Lodha Adrina",
"url": "https://www.magicbricks.com/lodha-adrina-worli-mumbai-pdpid-4d4235343033313539",
"developer": "Lodha Developers Limited",
"developer_id": "54016",
"rera": [
"[trimmed-depth]"
]
},
"amenities": [
"Sea facing",
"Theme based Architectures",
"Private pool"
],
"nearby": [
{
"category": "[trimmed-depth]",
"name": "[trimmed-depth]",
"distance_text": "[trimmed-depth]",
"id": "[trimmed-depth]"
},
{
"category": "[trimmed-depth]",
"name": "[trimmed-depth]",
"distance_text": "[trimmed-depth]",
"id": "[trimmed-depth]"
},
{
"category": "[trimmed-depth]",
"name": "[trimmed-depth]",
"distance_text": "[trimmed-depth]",
"id": "[trimmed-depth]"
}
],
"lister": {
"type": "Agent",
"id": "74068475",
"name": "Cushman and Wakefield",
"company": "Cushman and Wakefield",
"operating_since": null,
"rera_registration": null,
"rera_registered": null,
"certified": null,
"rating": null,
"buyers_served": null,
"listings_count": null,
"employees": null,
"photo": null,
"profile_url": "https://www.magicbricks.com/bricks/property-agent-details/broker--in-Mumbai-agentid-4d423734303638343735"
},
"images": [
"https://img.staticmb.com/mbphoto/property/cropped_images/ver2/XIwvQlc61t8ZIpanz4mAnTVO-dQ9dMj84yR0Imh0aVtDGzaxEmDj/Photo_h470_w1080/86853059_6_odhaAdrina1_470_1080.jpg",
"https://img.staticmb.com/mbphoto/property/cropped_images/ver2/XIwvQlc61t8ZIpanz4mAnTVP9dY9dMNnafqwc6bH2m2u5IH7EzMp/Photo_h470_w1080/86853059_2_hatsAppImage20261009at1.25.16PM_470_1080.jpeg"
],
"cover_image": "https://img.staticmb.com/mbphoto/property/cropped_images/ver2/XIwvQlc61t8ZIpanz4mAnTVO-dQ9dMj84yR0Imh0aVtDGzaxEmDj/Photo_h180_w240/86853059_6_odhaAdrina1_180_240.jpg",
"image_count": 2,
"videos": [
"https://www.youtube.com/shorts/KVETuyM-a4U"
],
"verified": false,
"rera_registered": true,
"rera_id": "A52000000914",
"mb_exclusive": null,
"is_project_unit": false,
"nri_preferred": null,
"commercial": null,
"plot": {
"floors_allowed": 1
},
"approved_by": "MCGM",
"gated_community": null,
"legal_documents": [],
"infrastructure": [],
"posted_at": "2026-10-09T07:57:47Z",
"posted_label": "Posted: Oct 09, '26",
"expires_at": "2026-12-08T18:30:00Z"
},
{
"id": "87284085",
"url": "https://www.magicbricks.com/propertyDetails/2-BHK-1040-Sq-ft-Multistorey-Apartment-FOR-Sale-Mulund-West-in-Mumbai&id=4d423837323834303835",
"title": "2BHK Multistorey Apartment for New Property in Piramal Revanta at Mulund West",
"transaction": "buy",
"transaction_type": "New Property",
"property_type": "Apartment",
"property_type_key": "apartment",
"price_inr": 29969000,
"price_display": "2.99 Cr",
"price_per_sqft_inr": null,
"booking_amount_inr": null,
"security_deposit_inr": null,
"maintenance_inr": null,
"maintenance_frequency": null,
"brokerage_inr": null,
"offer": null,
"bedrooms": 2,
"bathrooms": 2,
"balconies": 1,
"carpet_area": {
"value": 1040,
"unit": "Sq-ft"
},
"covered_area": null,
"plot_area": null,
"covered_area_sqft": null,
"furnishing": "Unfurnished",
"floor": null,
"floor_number": null,
"total_floors": null,
"facing": null,
"overlooking": null,
"possession_status": "[redacted-secret]",
"available_from": null,
"construction_age": "Less than 5 years",
"ownership": null,
"parking": null,
"flooring": null,
"power_backup": null,
"water_availability": null,
"additional_rooms": null,
"tenant_preference": "Bachelors/Family",
"in_society": false,
"description": "Multistorey Apartment for Sale in Mulund West, Mumbai. Covered area is 1040.0 Sq-ft. This property belongs to \"Piramal Revanta\" .",
"summary": "This lovely 2 BHK flat is for sale in Mulund West, Mumbai.This unit forms part of Piramal Revanta which is 9 years old. Available at price of ₹2.99 Cr , this ready to move flat in Mulund West is an excellent choice. P51800054164 is the RERA number of the project. In Piramal Revanta, property prices range from ₹2.46 Cr - ₹4.21 Cr, with multiple configurations across 1,2,3,4,5 bhk flats.",
"highlights": [],
"location": {
"locality_id": "78887",
"locality": "Mulund West",
"city_id": "4320",
"city": "Mumbai",
"landmark": null,
"address": "Piramal Revanta, Behind Nirmal Lifestyle mall, Goregaon Mulund Link Road, Mulund West",
"latitude": 19.1664448,
"longitude": 72.9360137
},
"project": {
"id": "5098339",
"name": "Piramal Revanta",
"url": "https://www.magicbricks.com/piramal-revanta-mulund-west-mumbai-pdpid-4d4235303938333339",
"developer": "Piramal Realty",
"developer_id": "74380",
"rera": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
]
},
"amenities": [],
"nearby": [
{
"category": "[trimmed-depth]",
"name": "[trimmed-depth]",
"distance_text": "[trimmed-depth]",
"id": "[trimmed-depth]"
},
{
"category": "[trimmed-depth]",
"name": "[trimmed-depth]",
"distance_text": "[trimmed-depth]",
"id": "[trimmed-depth]"
}
],
"__trimmed": "response capped for page display"
}
],
"__trimmed": "response capped for page display"
},
"__trimmed": "response capped for page display"
}What the Magicbricks (India) API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search sale or rent listings in an Indian city (30 a page, up to 100 pages): price in rupees with ₹/sq.ft, BHK, area, furnishing, floor, facing, possession, locality with coordinates, project and developer, amenities, nearby places, the lister (owner / agent / builder with name and company) and photos. Every filter of the site's own form: budget, BHK, property type, area, furnishing, possession, availability, sale type, posted since, posted by, ownership, age, bathrooms, facing, floor, amenities, verified, RERA, offers, commercial cabins / pantry / parking, zone, keyword. | Real-estate investors call search to search sale or rent listings in an Indian city (30 a page, up to 100 pages). | city, transaction, locality, segment, property_type, ... |
| property | One listing in full: price, market estimate and EMI, rooms, carpet / covered area, floor, facing, overlooking, possession, age, ownership, amenities, address and coordinates, the project (units, towers, launch and possession dates, price range, brochure, RERA ids, approving banks), the lister (name, company, address, operating since, listing counts, localities served), nearby places with distance, the 12-month ₹/sq.ft trend of the locality, every photo. | Brokerage tools call property to get one listing in full. | property |
| similar | The listings the site recommends next to one listing: its 'similar properties from builders' list and its 'top matches' list (10 each when the site has them), in the same row shape as search. | Property dashboards call similar to get the listings the site recommends next to one listing. | property |
| locations | Autocomplete a place or project: localities, cities, projects, PG names and landmarks, each with the site's id, city id and coordinates. The ids feed `city`, `locality` and `project` everywhere. | Lead-generation teams call locations to get autocomplete a place or project. | query |
| filters | The search form the site shows for one city: every filter with its options and the city's own zones and top localities (zone / locality ids for search). | Real-estate investors call filters to get the search form the site shows for one city. | city, transaction, segment |
| project_listings | The live sale or rent listings inside one project, in the search row shape (30 a page). | Brokerage tools call project_listings to get the live sale or rent listings inside one project, in the search row shape (30 a page).. | project, transaction, page |
| agent_listings | One agent's or lister's live sale or rent listings (30 a page), optionally inside one city. | Property dashboards call agent_listings to get one agent's or lister's live sale or rent listings (30 a page), optionally inside one city.. | agent, transaction, city, page |
| projects | New and upcoming projects in a city or one of its localities (20 a page): name, developer, BHK mix and unit sizes, price range, ₹/sq.ft range, launch and possession dates, units, towers, RERA flags, rating and review count, photos, brochure. | Lead-generation teams call projects to get new and upcoming projects in a city or one of its localities (20 a page). | city, locality, bedrooms, price_min, price_max, ... |
| project | One project in full: status, developer profile, address, area, ₹/sq.ft range, unit configurations and floor plans, unit pricing, amenities, ratings, project + locality price trends, RERA registration, resident and locality reviews, FAQs, similar projects, photo gallery. | Real-estate investors call project to get one project in full. | project |
| project_reviews | A project's resident reviews and category ratings, plus its locality's reviews and ratings. | Brokerage tools call project_reviews to get a project's resident reviews and category ratings, plus its locality's reviews and ratings.. | project |
| project_rera | A project's RERA registrations and the documents the site links (commencement certificates, approved layouts, legal title reports, quarterly progress reports), plus the RERA registry table the site prints. 2-4 small upstream requests (the RERA page is addressed by the project's name slug). | Property dashboards call project_rera to get a project's RERA registrations and the documents the site links (commencement certificates, a…. | project |
| agents | The site's top agents of a city or a locality (one page, ~100 agents): name, company, base locality, operating since, sale and rent listing counts, deals closed, team size, deal types, localities served, about text, photo, logo, profile link. | Lead-generation teams call agents to get the site's top agents of a city or a locality (one page, ~100 agents). | city, locality, transaction |
| agent | One agent's public profile: name, company, address, operating since, experience, deal types, localities served, sale / rent counts and price ranges, team size, verified listings, buyers served, certifications, photo, logo. | Real-estate investors call agent to get one agent's public profile. | agent |
| locality_trends | A locality's price trend: average ₹ per sq.ft for every quarter of the last 5 years for sale or rent and one property type, with the site's own quarterly and yearly change table. | Brokerage tools call locality_trends to get a locality's price trend. | locality, city, transaction, property_type |
| pg_search | Paying-guest (PG) / hostel / co-living listings in a city (30 a page): name, who it is for, room types with rent, locality, description, rating, photo. Filters: gender, occupancy, tenant type, posted by, budget, AC, Wi-Fi, food, laundry and the other options of the site's PG form. | Property dashboards call pg_search to get paying-guest (PG) / hostel / co-living listings in a city (30 a page). | city, locality, gender, occupancy, tenant_type, ... |
| pg | One PG / hostel in full: rent from, deposit, maintenance, notice period, electricity, food, who it is for, total beds, operating since, room options, amenities, house rules, rating. | Lead-generation teams call pg to get one PG / hostel in full. | pg |
Call search from your stack
curl -X POST https://api.reefapi.com/magicbricks/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"city":"Mumbai","bedrooms":"2"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/magicbricks/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"city": "Mumbai",
"bedrooms": "2"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/magicbricks/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"city": "Mumbai",
"bedrooms": "2"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.magicbricks.search with {"city":"Mumbai","bedrooms":"2"}.Who uses this API and why
- Track asking prices and rents per city, locality and BHK across India.
- Build owner-listing and agent lead lists with names, companies and listing counts.
- Monitor new launches and under-construction projects with their RERA documents.
- Compare locality price trends and rental deposits before an investment.
- Feed a rental or PG search product with live inventory and room rents.
Questions developers ask before integrating
Is there a Magicbricks API?
Yes. The magicbricks API on ReefAPI returns magicbricks.com listings for sale and rent, full listings with price breakup, new projects with RERA documents, agents, PGs and locality price trends as JSON, read logged out, no Magicbricks account needed.
Which cities are covered?
Every city Magicbricks lists. On 2026-11-15 the API was run for Mumbai, Bangalore, New Delhi, Pune, Hyderabad, Chennai, Gurgaon, Noida, Kolkata, Ahmedabad, Thane and Navi Mumbai, for sale and rent: 24 of 24 returned listings. Pass a city name in any common spelling (Bengaluru, Gurugram, Delhi and Bombay work as well as the site's own Bangalore, Gurgaon, New Delhi and Mumbai) or the site's city id; `locations` returns ids for cities, localities and projects.
Which filters can I use?
Budget, BHK, property type, area (sq.ft, sq.yd or sq.m), furnishing, possession and possession year, availability (rent), sale type (new or resale), posted since, posted by owner / agent / builder, ownership, construction age, bathrooms, facing, floor, amenities, verified, RERA registered, RERA or certified agent, with photos, with offers, Magicbricks exclusive, tenant preference and society only (rent), zone, keyword, project and agent, and for commercial property cabins, pantry, parking and pre-leased. Each was checked against the unfiltered total on 2026-11-15: Mumbai sale 64,158, 2 BHK 21,613, owner listings 21,270, ready to move 42,086, RERA registered 10,195.
How deep can I page?
30 listings a page and 100 pages per search, the site's own limit: 3,000 listings. Pages 1-5, 49-52 and 99-100 of a Mumbai search returned 330 different listings, for sale and for rent. Use localities or filters to split a larger search.
Do I get the owner's or agent's phone number or e-mail?
No. Magicbricks shows phone numbers and e-mail addresses only to visitors who log in, so the API returns neither. It returns the masked number the listing page shows as phone_masked, and the lister's type, name, company, operating since, RERA registration and listing counts as the site shows them.
Does it cover new projects and RERA?
Yes. `projects` lists a city's or locality's new projects (Mumbai: 3,747 on 2026-11-15, 20 a page) with developer, BHK mix, price range, possession and RERA flags. `project` returns one project with unit plans and prices, amenities, ratings, price trends, FAQs and similar projects; `project_rera` returns its RERA registration numbers and the documents the site links (commencement certificates, approved layouts, title reports, progress reports) as PDF links.
Can I get price trends for a locality?
Yes. `locality_trends` returns 21 quarters (5 years) of average ₹ per sq.ft for sale or rent and one property type, with the site's yearly change table. Santacruz West, Mumbai apartments: ₹34,804 in Oct 2021, ₹44,326 in Oct 2026.
Does it cover PGs and co-living?
Yes. `pg_search` returns paying-guest homes in a city with room types and rents (Mumbai: 2,902 on 2026-11-15) and filters for gender, sharing, tenant type, budget, AC, Wi-Fi, food and more; `pg` returns one PG with deposit, notice period, amenities and house rules. The PG list's first page also carries promoted PGs that can repeat on later pages; de-duplicate on id.
What is the Magicbricks (India) API?
Magicbricks (India) API is a ReefAPI endpoint group for india property listings for sale and rent with every site filter, full listings, new projects with rera documents, agents, pgs and locality price trends. It returns live JSON through POST requests under /magicbricks/v1.
Is the Magicbricks (India) API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Magicbricks (India) calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Magicbricks (India) login or account?
No login to Magicbricks (India) is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Magicbricks (India) data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Magicbricks (India) API use?
Magicbricks (India) actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Magicbricks (India) from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call magicbricks actions with the same key, credit pool and JSON envelope used by normal REST requests.