{"openapi":"3.0.3","info":{"title":"Magicbricks API (ReefAPI)","version":"1.0.0","description":"Magicbricks API — India property listings for sale and rent (residential + commercial), PG / co-living, new projects with RERA documents, agents, locality price trends Call POST /magicbricks/v1/{action} with an x-api-key header; every response is the { ok, data, meta, error } envelope.","contact":{"name":"ReefAPI","url":"https://reefapi.com/magicbricks-api","email":"support@reefapi.com"},"license":{"name":"ReefAPI Terms","url":"https://reefapi.com/terms"},"termsOfService":"https://reefapi.com/terms"},"externalDocs":{"description":"Magicbricks API documentation","url":"https://reefapi.com/docs/magicbricks"},"servers":[{"url":"https://api.reefapi.com"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"magicbricks","description":"Magicbricks API — India property listings for sale and rent (residential + commercial), PG / co-living, new projects with RERA documents, agents, locality price trends"}],"paths":{"/magicbricks/v1/search":{"post":{"operationId":"magicbricks_search","summary":"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 deve","description":"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.","tags":["magicbricks"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"transaction":{"type":"string","enum":["buy","rent"],"default":"buy","description":"buy (default) or rent. Accepts sale/sell/lease too."},"city":{"type":"string","example":"Mumbai","description":"City name in any common spelling (`Mumbai`/`Bombay`, `Bangalore`/`Bengaluru`, `Gurgaon`/`Gurugram`, `New Delhi`/`Delhi`…) or the site's numeric city id (`4320` = Mumbai; action `locations` lists ids)."},"locality":{"type":"array","items":{"type":"string"},"description":"One or more localities of the city, comma-separated: names (`Andheri West`) or numeric locality ids (`60018`) from action `locations`. An unknown name is refused."},"segment":{"type":"string","enum":["residential","commercial","agricultural"],"description":"residential, commercial or agricultural — the site's own property-type groups. Overridden by property_type."},"property_type":{"type":"array","items":{"type":"string","enum":["flat","house_villa","plot","office","shop_showroom","commercial_land","warehouse","industrial_building","industrial_shed","coworking","agricultural_land","farm_house"]},"description":"One or more property types (comma-separated) — the site's own groups; single names such as apartment, villa, shop, penthouse are accepted and map to their group. Each row's `property_type` says the exact type."},"bedrooms":{"type":"array","items":{"type":"string","enum":["1","2","3","4","5","5+"]},"description":"One or more BHK counts: 1, 2, 3, 4, 5, 5+ (comma-separated)."},"price_min":{"type":"integer","minimum":0,"description":"Minimum price in rupees (sale price, or monthly rent for rent)."},"price_max":{"type":"integer","minimum":0,"description":"Maximum price in rupees."},"area_min":{"type":"integer","minimum":0,"description":"Minimum covered area (unit: area_unit)."},"area_max":{"type":"integer","minimum":0,"description":"Maximum covered area (unit: area_unit)."},"area_unit":{"type":"string","enum":["sqft","sqyrd","sqm"],"default":"sqft","description":"Unit of area_min / area_max (default sqft)."},"furnishing":{"type":"array","items":{"type":"string","enum":["furnished","semi_furnished","unfurnished"]},"description":"Furnishing (comma-separated for several)."},"possession":{"type":"string","enum":["ready_to_move","under_construction"],"description":"Buy only: ready to move or under construction."},"possession_by":{"type":"integer","minimum":2026,"maximum":2033,"description":"Buy only: possession year (2026-2033); the site's own 'Possession between' filter. Loose upstream — rows with a later date come back."},"availability":{"type":"string","enum":["immediately","within_1_month","1_to_3_months","3_to_6_months","after_6_months"],"description":"Rent only: when the home is available."},"sale_type":{"type":"string","enum":["new","resale"],"description":"Buy only: new (from the builder) or resale."},"posted_since":{"type":"string","enum":["yesterday","last_week","last_2_weeks","last_3_weeks","last_month","last_2_months","last_4_months"],"description":"Listings posted within this window."},"posted_by":{"type":"array","items":{"type":"string","enum":["owner","agent","builder"]},"description":"Owner, agent and/or builder listings (comma-separated)."},"ownership":{"type":"array","items":{"type":"string","enum":["freehold","leasehold","power_of_attorney","cooperative_society"]},"description":"Buy only: ownership type (comma-separated)."},"construction_age":{"type":"string","enum":["new_construction","under_5_years","5_to_10_years","10_to_15_years","15_to_20_years","over_20_years"],"description":"Buy only: age of construction."},"bathrooms":{"type":"array","items":{"type":"string","enum":["1","2","3","4","5"]},"description":"One or more bathroom counts 1-5 (comma-separated)."},"facing":{"type":"array","items":{"type":"string","enum":["east","north","north_east","north_west","south","south_east","south_west","west"]},"description":"Facing direction(s), comma-separated."},"floor":{"type":"array","items":{"type":"string","enum":["basement","ground","1_to_4","5_to_8","9_to_12","13_to_16","above_16"]},"description":"Floor band(s), comma-separated."},"amenities":{"type":"array","items":{"type":"string","enum":["reserved_parking","lift","power_backup","piped_gas","park","kids_play_area","gymnasium","swimming_pool","club_house","vaastu_compliant","air_conditioned","wifi"]},"description":"Amenities the listing must have (comma-separated)."},"locality_class":{"type":"array","items":{"type":"string","enum":["upcoming","developed","premium"]},"description":"The site's locality classes: upcoming, developed or premium."},"tenant_preference":{"type":"string","enum":["bachelors","family"],"description":"Rent only: bachelors or family."},"verified":{"type":"boolean","description":"Only verified listings."},"rera_registered":{"type":"boolean","description":"Buy only: only RERA-registered listings."},"rera_agent":{"type":"boolean","description":"Only listings by RERA-registered agents."},"certified_agent":{"type":"boolean","description":"Only listings by certified agents."},"with_photos":{"type":"boolean","description":"Only listings with photos."},"with_offers":{"type":"boolean","description":"Only listings carrying an offer / discount."},"mb_exclusive":{"type":"boolean","description":"Only Magicbricks-exclusive listings."},"society_only":{"type":"boolean","description":"Rent only: only homes inside a housing society."},"pre_leased":{"type":"boolean","description":"Commercial: only pre-leased (tenanted) properties."},"commercial_guru":{"type":"boolean","description":"Commercial: only listings by the site's 'Commercial Guru' agents."},"cabins_min":{"type":"integer","minimum":1,"maximum":5,"description":"Commercial: at least this many cabins (1-5)."},"parking_min":{"type":"integer","minimum":1,"maximum":5,"description":"Commercial: at least this many parking spots (1-5)."},"pantry":{"type":"array","items":{"type":"string","enum":["dry","wet"]},"description":"Commercial: pantry type."},"zone":{"type":"string","description":"The site's zone / corridor id (action `filters` lists a city's zones, e.g. 50121)."},"keyword":{"type":"string","description":"Free-text keyword the site matches in listings (e.g. `sea view`)."},"project":{"type":"string","description":"Only listings inside this project: numeric project id (psmid), its hex id or a project URL."},"agent":{"type":"string","description":"Only listings of this agent / lister: numeric id (oid), hex id or an agent URL."},"sort":{"type":"string","enum":["relevance","newest","price_low","price_high","rate_low","rate_high"],"description":"Order of the rows (default relevance)."},"page":{"type":"integer","minimum":1,"maximum":100,"default":1,"description":"Page number, 1-100. 30 rows a page. The site serves at most 100 pages (3000 rows) per search; page 101+ would repeat page 1, so it is refused."}}},"example":{"city":"Mumbai","bedrooms":"2"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/magicbricks/v1/property":{"post":{"operationId":"magicbricks_property","summary":"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, tower","description":"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.","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"property":{"type":"string","example":"86337053","description":"The listing: numeric id, the site's hex id or a magicbricks.com listing URL."}},"required":["property"]},"example":{"property":"86337053"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":3}},"/magicbricks/v1/similar":{"post":{"operationId":"magicbricks_similar","summary":"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.","description":"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.","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"property":{"type":"string","example":"86337053","description":"The listing: numeric id, the site's hex id or a magicbricks.com listing URL."}},"required":["property"]},"example":{"property":"86337053"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/magicbricks/v1/locations":{"post":{"operationId":"magicbricks_locations","summary":"Autocomplete a place or project: localities, cities, projects, PG names and landmarks, each with the site's id, city id and coordinates","description":"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.","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","example":"andheri","description":"At least 3 letters of a place, project or landmark."},"city":{"type":"string","description":"Optional city (name such as `Mumbai` / `Bengaluru`, or id such as 4320) to narrow the suggestions."}},"required":["query"]},"example":{"query":"andheri"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/magicbricks/v1/filters":{"post":{"operationId":"magicbricks_filters","summary":"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).","description":"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).","tags":["magicbricks"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"transaction":{"type":"string","enum":["buy","rent"],"default":"buy","description":"buy (default) or rent. Accepts sale/sell/lease too."},"city":{"type":"string","example":"Mumbai","description":"City name in any common spelling (`Mumbai`/`Bombay`, `Bangalore`/`Bengaluru`, `Gurgaon`/`Gurugram`, `New Delhi`/`Delhi`…) or the site's numeric city id (`4320` = Mumbai; action `locations` lists ids)."},"segment":{"type":"string","enum":["residential","commercial","agricultural"],"description":"residential, commercial or agricultural — the site's own property-type groups. Overridden by property_type."}}},"example":{"city":"Mumbai"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/magicbricks/v1/project_listings":{"post":{"operationId":"magicbricks_project_listings","summary":"The live sale or rent listings inside one project, in the search row shape (30 a page).","description":"The live sale or rent listings inside one project, in the search row shape (30 a page).","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project":{"type":"string","example":"5366197","description":"The project: numeric id, the site's hex id or a magicbricks.com project URL."},"transaction":{"type":"string","enum":["buy","rent"],"default":"buy","description":"buy (default) or rent. Accepts sale/sell/lease too."},"page":{"type":"integer","minimum":1,"maximum":100,"default":1,"description":"Page number, 1-100. 30 rows a page. The site serves at most 100 pages (3000 rows) per search; page 101+ would repeat page 1, so it is refused."}},"required":["project"]},"example":{"project":"5366197"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/magicbricks/v1/agent_listings":{"post":{"operationId":"magicbricks_agent_listings","summary":"One agent's or lister's live sale or rent listings (30 a page), optionally inside one city.","description":"One agent's or lister's live sale or rent listings (30 a page), optionally inside one city.","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agent":{"type":"string","example":"11386977","description":"The agent: numeric id, the site's hex id or a magicbricks.com agent URL."},"transaction":{"type":"string","enum":["buy","rent"],"default":"buy","description":"buy (default) or rent. Accepts sale/sell/lease too."},"city":{"type":"string","description":"Optional city name or id."},"page":{"type":"integer","minimum":1,"maximum":100,"default":1,"description":"Page number, 1-100. 30 rows a page. The site serves at most 100 pages (3000 rows) per search; page 101+ would repeat page 1, so it is refused."}},"required":["agent"]},"example":{"agent":"11386977"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/magicbricks/v1/projects":{"post":{"operationId":"magicbricks_projects","summary":"New and upcoming residential 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, R","description":"New and upcoming residential 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.","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"city":{"type":"string","example":"Mumbai","description":"City name (`Mumbai`, `Pune`, `New Delhi`, `Bengaluru`…) or the site's city id (4320)."},"locality":{"type":"string","description":"Optional locality name of that city, e.g. `Andheri West`."},"bedrooms":{"type":"array","items":{"type":"string","enum":["1","2","3","4","5","5+"]},"description":"One or more BHK counts (1-5, 5+)."},"price_min":{"type":"integer","minimum":0,"description":"Minimum price in rupees."},"price_max":{"type":"integer","minimum":0,"description":"Maximum price in rupees."},"possession":{"type":"string","enum":["ready_to_move","under_construction"],"description":"Ready to move or under construction."},"page":{"type":"integer","minimum":1,"maximum":500,"default":1,"description":"Page number (20 projects a page). A page past the last returns 0 rows."}},"required":["city"]},"example":{"city":"Pune"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/magicbricks/v1/project":{"post":{"operationId":"magicbricks_project","summary":"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,","description":"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.","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project":{"type":"string","example":"5366197","description":"The project: numeric id, the site's hex id or a magicbricks.com project URL."}},"required":["project"]},"example":{"project":"5366197"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":3}},"/magicbricks/v1/project_reviews":{"post":{"operationId":"magicbricks_project_reviews","summary":"A project's resident reviews and category ratings, plus its locality's reviews and ratings.","description":"A project's resident reviews and category ratings, plus its locality's reviews and ratings.","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project":{"type":"string","example":"5366197","description":"The project: numeric id, the site's hex id or a magicbricks.com project URL."}},"required":["project"]},"example":{"project":"5366197"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":3}},"/magicbricks/v1/project_rera":{"post":{"operationId":"magicbricks_project_rera","summary":"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 pr","description":"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).","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project":{"type":"string","example":"5366197","description":"The project: numeric id, the site's hex id or a magicbricks.com project URL."}},"required":["project"]},"example":{"project":"5366197"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/magicbricks/v1/agents":{"post":{"operationId":"magicbricks_agents","summary":"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 serv","description":"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.","tags":["magicbricks"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"city":{"type":"string","description":"City name (`Mumbai`, `Bengaluru`, `Gurugram`…) or id (4320)."},"locality":{"type":"string","description":"Locality id (from `locations`) — narrows to that locality's agents."},"transaction":{"type":"string","enum":["buy","rent"],"default":"buy","description":"buy (default) or rent. Accepts sale/sell/lease too."}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/magicbricks/v1/agent":{"post":{"operationId":"magicbricks_agent","summary":"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, certif","description":"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.","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agent":{"type":"string","example":"11386977","description":"The agent: numeric id, the site's hex id or a magicbricks.com agent URL."}},"required":["agent"]},"example":{"agent":"11386977"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/magicbricks/v1/locality_trends":{"post":{"operationId":"magicbricks_locality_trends","summary":"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.","description":"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.","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locality":{"type":"string","example":"78896","description":"Locality id from `locations` (e.g. 78896), or a name with `city`."},"city":{"type":"string","description":"City id or name, used to resolve a locality NAME."},"transaction":{"type":"string","enum":["buy","rent"],"default":"buy","description":"buy (default) or rent. Accepts sale/sell/lease too."},"property_type":{"type":"string","enum":["apartment","builder_floor","house","plot","office","shop"],"default":"apartment","description":"apartment (default), builder_floor, house, plot, office or shop."}},"required":["locality"]},"example":{"locality":"78896"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/magicbricks/v1/pg_search":{"post":{"operationId":"magicbricks_pg_search","summary":"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","description":"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.","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"city":{"type":"string","example":"4320","description":"City name (`Mumbai`, `Bengaluru`…) or id (4320)."},"locality":{"type":"string","description":"Locality name(s), comma-separated."},"gender":{"type":"array","items":{"type":"string","enum":["boys","girls","both"]},"description":"Boys, girls or both."},"occupancy":{"type":"array","items":{"type":"string","enum":["single","double","triple","others"]},"description":"Room sharing."},"tenant_type":{"type":"array","items":{"type":"string","enum":["professionals","students"]},"description":"Professionals or students."},"posted_by":{"type":"array","items":{"type":"string","enum":["owner","property_manager","agent"]},"description":"Owner, property manager or agent."},"price_min":{"type":"integer","minimum":0,"description":"Minimum rent in rupees."},"price_max":{"type":"integer","minimum":0,"description":"Maximum rent in rupees."},"ac":{"type":"boolean","description":"Only PGs with: AC rooms."},"power_backup":{"type":"boolean","description":"Only PGs with: Power backup."},"washing_machine":{"type":"boolean","description":"Only PGs with: Washing machine."},"wifi":{"type":"boolean","description":"Only PGs with: Wi-Fi."},"attached_washroom":{"type":"boolean","description":"Only PGs with: Attached washroom."},"room_cleaning":{"type":"boolean","description":"Only PGs with: Room cleaning."},"laundry":{"type":"boolean","description":"Only PGs with: Laundry."},"verified":{"type":"boolean","description":"Only PGs with: Verified PG."},"food_provided":{"type":"boolean","description":"Only PGs with: Food provided."},"non_veg_allowed":{"type":"boolean","description":"Only PGs with: Non-veg allowed."},"self_cooking":{"type":"boolean","description":"Only PGs with: Self-cooking kitchen."},"page":{"type":"integer","minimum":1,"maximum":500,"default":1,"description":"Page number."}},"required":["city"]},"example":{"city":"Mumbai"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":3}},"/magicbricks/v1/pg":{"post":{"operationId":"magicbricks_pg","summary":"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.","description":"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.","tags":["magicbricks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pg":{"type":"string","example":"https://www.magicbricks.com/propertyDetail/antilla-pg-nav-pada-in-mumbai&pgid=4d423130323433677261646531","description":"The `url` of a pg_search row (magicbricks.com/propertyDetail/…&pgid=…)."}},"required":["pg"]},"example":{"pg":"https://www.magicbricks.com/propertyDetail/antilla-pg-nav-pada-in-mumbai&pgid=4d423130323433677261646531"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Envelope":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"data":{"description":"Action result (shape varies per action)"},"meta":{"type":"object","description":"api, endpoint, mode, latency_ms, record_count, completeness_pct"},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}}}}}}}}