# Magicbricks API — India property listings for sale and rent (residential + commercial), PG / co-living, new projects with RERA documents, agents, locality price trends

> 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.
> ReefAPI engine `magicbricks` · 16 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/magicbricks/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/magicbricks/v1/search — 1 credit
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.

**Parameters:**
- `transaction` (enum, optional, default "buy") — buy (default) or rent. Accepts sale/sell/lease too. [one of: buy, rent]
- `city` (string, optional) — 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` (array, optional) — 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` (enum, optional) — residential, commercial or agricultural — the site's own property-type groups. Overridden by property_type. [one of: residential, commercial, agricultural]
- `property_type` (array, optional) — 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. [one of: flat, house_villa, plot, office, shop_showroom, commercial_land, warehouse, industrial_building, industrial_shed, coworking, agricultural_land, farm_house]
- `bedrooms` (array, optional) — One or more BHK counts: 1, 2, 3, 4, 5, 5+ (comma-separated). [one of: 1, 2, 3, 4, 5, 5+]
- `price_min` (integer, optional) — Minimum price in rupees (sale price, or monthly rent for rent).
- `price_max` (integer, optional) — Maximum price in rupees.
- `area_min` (integer, optional) — Minimum covered area (unit: area_unit).
- `area_max` (integer, optional) — Maximum covered area (unit: area_unit).
- `area_unit` (enum, optional, default "sqft") — Unit of area_min / area_max (default sqft). [one of: sqft, sqyrd, sqm]
- `furnishing` (array, optional) — Furnishing (comma-separated for several). [one of: furnished, semi_furnished, unfurnished]
- `possession` (enum, optional) — Buy only: ready to move or under construction. [one of: ready_to_move, under_construction]
- `possession_by` (integer, optional) — Buy only: possession year (2026-2033); the site's own 'Possession between' filter. Loose upstream — rows with a later date come back.
- `availability` (enum, optional) — Rent only: when the home is available. [one of: immediately, within_1_month, 1_to_3_months, 3_to_6_months, after_6_months]
- `sale_type` (enum, optional) — Buy only: new (from the builder) or resale. [one of: new, resale]
- `posted_since` (enum, optional) — Listings posted within this window. [one of: yesterday, last_week, last_2_weeks, last_3_weeks, last_month, last_2_months, last_4_months]
- `posted_by` (array, optional) — Owner, agent and/or builder listings (comma-separated). [one of: owner, agent, builder]
- `ownership` (array, optional) — Buy only: ownership type (comma-separated). [one of: freehold, leasehold, power_of_attorney, cooperative_society]
- `construction_age` (enum, optional) — Buy only: age of construction. [one of: new_construction, under_5_years, 5_to_10_years, 10_to_15_years, 15_to_20_years, over_20_years]
- `bathrooms` (array, optional) — One or more bathroom counts 1-5 (comma-separated). [one of: 1, 2, 3, 4, 5]
- `facing` (array, optional) — Facing direction(s), comma-separated. [one of: east, north, north_east, north_west, south, south_east, south_west, west]
- `floor` (array, optional) — Floor band(s), comma-separated. [one of: basement, ground, 1_to_4, 5_to_8, 9_to_12, 13_to_16, above_16]
- `amenities` (array, optional) — Amenities the listing must have (comma-separated). [one of: reserved_parking, lift, power_backup, piped_gas, park, kids_play_area, gymnasium, swimming_pool, club_house, vaastu_compliant, air_conditioned, wifi]
- `locality_class` (array, optional) — The site's locality classes: upcoming, developed or premium. [one of: upcoming, developed, premium]
- `tenant_preference` (enum, optional) — Rent only: bachelors or family. [one of: bachelors, family]
- `verified` (boolean, optional) — Only verified listings.
- `rera_registered` (boolean, optional) — Buy only: only RERA-registered listings.
- `rera_agent` (boolean, optional) — Only listings by RERA-registered agents.
- `certified_agent` (boolean, optional) — Only listings by certified agents.
- `with_photos` (boolean, optional) — Only listings with photos.
- `with_offers` (boolean, optional) — Only listings carrying an offer / discount.
- `mb_exclusive` (boolean, optional) — Only Magicbricks-exclusive listings.
- `society_only` (boolean, optional) — Rent only: only homes inside a housing society.
- `pre_leased` (boolean, optional) — Commercial: only pre-leased (tenanted) properties.
- `commercial_guru` (boolean, optional) — Commercial: only listings by the site's 'Commercial Guru' agents.
- `cabins_min` (integer, optional) — Commercial: at least this many cabins (1-5).
- `parking_min` (integer, optional) — Commercial: at least this many parking spots (1-5).
- `pantry` (array, optional) — Commercial: pantry type. [one of: dry, wet]
- `zone` (string, optional) — The site's zone / corridor id (action `filters` lists a city's zones, e.g. 50121).
- `keyword` (string, optional) — Free-text keyword the site matches in listings (e.g. `sea view`).
- `project` (string, optional) — Only listings inside this project: numeric project id (psmid), its hex id or a project URL.
- `agent` (string, optional) — Only listings of this agent / lister: numeric id (oid), hex id or an agent URL.
- `sort` (enum, optional) — Order of the rows (default relevance). [one of: relevance, newest, price_low, price_high, rate_low, rate_high]
- `page` (integer, optional, default 1) — 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.

**Returns:** listings[]{id, url, title, transaction, transaction_type, property_type, property_type_key, price_inr (sale price, or the monthly rent for rent listings), price_display, price_per_sqft_inr, booking_amount_inr, security_deposit_inr, maintenance_inr, maintenance_frequency, brokerage_inr, offer, bedrooms, bathrooms, balconies, carpet_area{value, unit}, covered_area, plot_area, covered_area_sqft, furnishing, floor, floor_number, total_floors, facing, overlooking, possession_status, available_from, construction_age, ownership, parking, flooring, power_backup, water_availability, additional_rooms, tenant_preference, society, description, summary, highlights[], location{locality_id, locality, city_id, city, landmark, address, latitude, longitude}, project{id, name, url, developer, developer_id, rera[]}, amenities[], nearby[]{category, name, distance_text, id}, lister{type, id, name, company, operating_since, rera_registration, rera_registered, certified, rating, buyers_served, listings_count, employees, photo, profile_url}, images[], cover_image, image_count, videos[], verified, rera_registered, rera_id, mb_exclusive, is_project_unit, nri_preferred, in_society, commercial{building_grade, zone, pantry, cabins, seats, pre_leased, …}, plot{dimensions, boundary_wall, corner_plot, road_width, open_sides, floors_allowed}, approved_by, gated_community, legal_documents[], infrastructure[], posted_at (the row's "Posted" date, UTC), posted_label, expires_at} + total + page + per_page + total_pages + has_next + page_ceiling + city{id, name} + localities[] + summary

**Example request body:**
```json
{
  "city": "Mumbai",
  "bedrooms": "2"
}
```

### POST https://api.reefapi.com/magicbricks/v1/property — 3 credits
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.

**Parameters:**
- `property` (string, required) — The listing: numeric id, the site's hex id or a magicbricks.com listing URL.

**Returns:** id, url, title, transaction, transaction_type, property_type, price_inr (sale price, or the monthly rent), price_display, price_per_sqft_inr, market_estimate_inr, emi_inr, home_loan_rate_pct, price_breakup{security_deposit_inr, monthly_rent_inr, brokerage, first_month_charges_inr, resale_price_inr, estimated_price, …}, booking_amount_inr, security_deposit_inr, bedrooms, bathrooms, balconies, carpet_area, covered_area, furnishing, floor_number, total_floors, facing, overlooking, possession_status, construction_age, ownership, description, summary, amenities[], location{…}, project{…}, lister{…}, images[], image_count, verified, nearby[]{category, name, distance_km, latitude, longitude}, price_trend{months[], series[], current[]}, posted_on, similar_listing_ids[]

**Example request body:**
```json
{
  "property": "86337053"
}
```

### POST https://api.reefapi.com/magicbricks/v1/similar — 2 credits
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.

**Parameters:**
- `property` (string, required) — The listing: numeric id, the site's hex id or a magicbricks.com listing URL.

**Returns:** property_id + builder_similar[] + top_matches[] (search row shape) + count

**Example request body:**
```json
{
  "property": "86337053"
}
```

### POST https://api.reefapi.com/magicbricks/v1/locations — 1 credit
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.

**Parameters:**
- `query` (string, required) — At least 3 letters of a place, project or landmark.
- `city` (string, optional) — Optional city (name such as `Mumbai` / `Bengaluru`, or id such as 4320) to narrow the suggestions.

**Returns:** count + results[]{type (locality|city|project|pg|landmark…), group, id, name, label, city_id, state_id, locality_id, developer, category, latitude, longitude}

**Example request body:**
```json
{
  "query": "andheri"
}
```

### POST https://api.reefapi.com/magicbricks/v1/filters — 2 credits
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).

**Parameters:**
- `transaction` (enum, optional, default "buy") — buy (default) or rent. Accepts sale/sell/lease too. [one of: buy, rent]
- `city` (string, optional) — 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` (enum, optional) — residential, commercial or agricultural — the site's own property-type groups. Overridden by property_type. [one of: residential, commercial, agricultural]

**Returns:** city + transaction + groups[]{title, group, options[]{value, label, site_param}, range_steps[]} + links{}

**Example request body:**
```json
{
  "city": "Mumbai"
}
```

### POST https://api.reefapi.com/magicbricks/v1/project_listings — 1 credit
The live sale or rent listings inside one project, in the search row shape (30 a page).

**Parameters:**
- `project` (string, required) — The project: numeric id, the site's hex id or a magicbricks.com project URL.
- `transaction` (enum, optional, default "buy") — buy (default) or rent. Accepts sale/sell/lease too. [one of: buy, rent]
- `page` (integer, optional, default 1) — 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.

**Returns:** listings[]{id, url, title, transaction, transaction_type, property_type, property_type_key, price_inr (sale price, or the monthly rent for rent listings), price_display, price_per_sqft_inr, booking_amount_inr, security_deposit_inr, maintenance_inr, maintenance_frequency, brokerage_inr, offer, bedrooms, bathrooms, balconies, carpet_area{value, unit}, covered_area, plot_area, covered_area_sqft, furnishing, floor, floor_number, total_floors, facing, overlooking, possession_status, available_from, construction_age, ownership, parking, flooring, power_backup, water_availability, additional_rooms, tenant_preference, society, description, summary, highlights[], location{locality_id, locality, city_id, city, landmark, address, latitude, longitude}, project{id, name, url, developer, developer_id, rera[]}, amenities[], nearby[]{category, name, distance_text, id}, lister{type, id, name, company, operating_since, rera_registration, rera_registered, certified, rating, buyers_served, listings_count, employees, photo, profile_url}, images[], cover_image, image_count, videos[], verified, rera_registered, rera_id, mb_exclusive, is_project_unit, nri_preferred, in_society, commercial{building_grade, zone, pantry, cabins, seats, pre_leased, …}, plot{dimensions, boundary_wall, corner_plot, road_width, open_sides, floors_allowed}, approved_by, gated_community, legal_documents[], infrastructure[], posted_at (the row's "Posted" date, UTC), posted_label, expires_at} + total + page + per_page + total_pages + has_next + page_ceiling + city{id, name} + localities[] + summary

**Example request body:**
```json
{
  "project": "5366197"
}
```

### POST https://api.reefapi.com/magicbricks/v1/agent_listings — 1 credit
One agent's or lister's live sale or rent listings (30 a page), optionally inside one city.

**Parameters:**
- `agent` (string, required) — The agent: numeric id, the site's hex id or a magicbricks.com agent URL.
- `transaction` (enum, optional, default "buy") — buy (default) or rent. Accepts sale/sell/lease too. [one of: buy, rent]
- `city` (string, optional) — Optional city name or id.
- `page` (integer, optional, default 1) — 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.

**Returns:** listings[]{id, url, title, transaction, transaction_type, property_type, property_type_key, price_inr (sale price, or the monthly rent for rent listings), price_display, price_per_sqft_inr, booking_amount_inr, security_deposit_inr, maintenance_inr, maintenance_frequency, brokerage_inr, offer, bedrooms, bathrooms, balconies, carpet_area{value, unit}, covered_area, plot_area, covered_area_sqft, furnishing, floor, floor_number, total_floors, facing, overlooking, possession_status, available_from, construction_age, ownership, parking, flooring, power_backup, water_availability, additional_rooms, tenant_preference, society, description, summary, highlights[], location{locality_id, locality, city_id, city, landmark, address, latitude, longitude}, project{id, name, url, developer, developer_id, rera[]}, amenities[], nearby[]{category, name, distance_text, id}, lister{type, id, name, company, operating_since, rera_registration, rera_registered, certified, rating, buyers_served, listings_count, employees, photo, profile_url}, images[], cover_image, image_count, videos[], verified, rera_registered, rera_id, mb_exclusive, is_project_unit, nri_preferred, in_society, commercial{building_grade, zone, pantry, cabins, seats, pre_leased, …}, plot{dimensions, boundary_wall, corner_plot, road_width, open_sides, floors_allowed}, approved_by, gated_community, legal_documents[], infrastructure[], posted_at (the row's "Posted" date, UTC), posted_label, expires_at} + total + page + per_page + total_pages + has_next + page_ceiling + city{id, name} + localities[] + summary

**Example request body:**
```json
{
  "agent": "11386977"
}
```

### POST https://api.reefapi.com/magicbricks/v1/projects — 1 credit
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.

**Parameters:**
- `city` (string, required) — City name (`Mumbai`, `Pune`, `New Delhi`, `Bengaluru`…) or the site's city id (4320).
- `locality` (string, optional) — Optional locality name of that city, e.g. `Andheri West`.
- `bedrooms` (array, optional) — One or more BHK counts (1-5, 5+). [one of: 1, 2, 3, 4, 5, 5+]
- `price_min` (integer, optional) — Minimum price in rupees.
- `price_max` (integer, optional) — Maximum price in rupees.
- `possession` (enum, optional) — Ready to move or under construction. [one of: ready_to_move, under_construction]
- `page` (integer, optional, default 1) — Page number (20 projects a page). A page past the last returns 0 rows.

**Returns:** projects[]{id, name, url, developer, developer_id, property_type, bedrooms[], units[], price_min_inr, price_max_inr, price_range, price_per_sqft_min_inr, price_per_sqft_max_inr, possession_date, launch_date, total_units, towers, project_area, rera_registered, rating, review_count, locality, city, pincode, usp[], description, brochure_url, images[], seller} + total + page + total_pages + has_next

**Example request body:**
```json
{
  "city": "Pune"
}
```

### POST https://api.reefapi.com/magicbricks/v1/project — 3 credits
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.

**Parameters:**
- `project` (string, required) — The project: numeric id, the site's hex id or a magicbricks.com project URL.

**Returns:** id, name, url, status, developer{…}, address, project_area, price_per_sqft_range, units_summary[], details{}, description, amenities[], ratings{}, price_trends{}, unit_pricing[], unit_plans[], rera{…}, listings_for_sale, listings_for_rent, seller{}, reviews{count, rating, ratings, reviews[]}, locality_reviews{…}, faqs[], similar_projects[], gallery[]

**Example request body:**
```json
{
  "project": "5366197"
}
```

### POST https://api.reefapi.com/magicbricks/v1/project_reviews — 3 credits
A project's resident reviews and category ratings, plus its locality's reviews and ratings.

**Parameters:**
- `project` (string, required) — The project: numeric id, the site's hex id or a magicbricks.com project URL.

**Returns:** id, name, url, ratings{}, reviews{count, rating, ratings, reviews[]}, locality_reviews{…}

**Example request body:**
```json
{
  "project": "5366197"
}
```

### POST https://api.reefapi.com/magicbricks/v1/project_rera — 2 credits
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).

**Parameters:**
- `project` (string, required) — The project: numeric id, the site's hex id or a magicbricks.com project URL.

**Returns:** id, name, developer, city, locality, rera[]{registration, valid_till}, rera_updated, documents[]{name, label, url}, registry{}, quarterly_reports_available

**Example request body:**
```json
{
  "project": "5366197"
}
```

### POST https://api.reefapi.com/magicbricks/v1/agents — 2 credits
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.

**Parameters:**
- `city` (string, optional) — City name (`Mumbai`, `Bengaluru`, `Gurugram`…) or id (4320).
- `locality` (string, optional) — Locality id (from `locations`) — narrows to that locality's agents.
- `transaction` (enum, optional, default "buy") — buy (default) or rent. Accepts sale/sell/lease too. [one of: buy, rent]

**Returns:** count + agents[]{id, name, company, base_location, operating_since, tag, sale_listings, rent_listings, deals_closed, team_members, deals_in, operates_in[], about, photo, logo, profile_url}

### POST https://api.reefapi.com/magicbricks/v1/agent — 1 credit
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.

**Parameters:**
- `agent` (string, required) — The agent: numeric id, the site's hex id or a magicbricks.com agent URL.

**Returns:** id, name, company, locality, city, address, operating_since, experience_years, about, deals_in, operates_in[], sale_listings, rent_listings, sale_price_range, rent_price_range, team_size, verified_listings, buyers_served, certified, locality_champion, rera_id, photo, logo, profile_url

**Example request body:**
```json
{
  "agent": "11386977"
}
```

### POST https://api.reefapi.com/magicbricks/v1/locality_trends — 2 credits
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.

**Parameters:**
- `locality` (string, required) — Locality id from `locations` (e.g. 78896), or a name with `city`.
- `city` (string, optional) — City id or name, used to resolve a locality NAME.
- `transaction` (enum, optional, default "buy") — buy (default) or rent. Accepts sale/sell/lease too. [one of: buy, rent]
- `property_type` (enum, optional, default "apartment") — apartment (default), builder_floor, house, plot, office or shop. [one of: apartment, builder_floor, house, plot, office, shop]

**Returns:** locality{id, name} + transaction + property_type + unit + quarters[] + series[]{name, avg_price_per_unit_inr[]} + summary + latest_quarter_table[] + yearly[]

**Example request body:**
```json
{
  "locality": "78896"
}
```

### POST https://api.reefapi.com/magicbricks/v1/pg_search — 3 credits
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.

**Parameters:**
- `city` (string, required) — City name (`Mumbai`, `Bengaluru`…) or id (4320).
- `locality` (string, optional) — Locality name(s), comma-separated.
- `gender` (array, optional) — Boys, girls or both. [one of: boys, girls, both]
- `occupancy` (array, optional) — Room sharing. [one of: single, double, triple, others]
- `tenant_type` (array, optional) — Professionals or students. [one of: professionals, students]
- `posted_by` (array, optional) — Owner, property manager or agent. [one of: owner, property_manager, agent]
- `price_min` (integer, optional) — Minimum rent in rupees.
- `price_max` (integer, optional) — Maximum rent in rupees.
- `ac` (boolean, optional) — Only PGs with: AC rooms.
- `power_backup` (boolean, optional) — Only PGs with: Power backup.
- `washing_machine` (boolean, optional) — Only PGs with: Washing machine.
- `wifi` (boolean, optional) — Only PGs with: Wi-Fi.
- `attached_washroom` (boolean, optional) — Only PGs with: Attached washroom.
- `room_cleaning` (boolean, optional) — Only PGs with: Room cleaning.
- `laundry` (boolean, optional) — Only PGs with: Laundry.
- `verified` (boolean, optional) — Only PGs with: Verified PG.
- `food_provided` (boolean, optional) — Only PGs with: Food provided.
- `non_veg_allowed` (boolean, optional) — Only PGs with: Non-veg allowed.
- `self_cooking` (boolean, optional) — Only PGs with: Self-cooking kitchen.
- `page` (integer, optional, default 1) — Page number.

**Returns:** pgs[]{id, pg_id, name, url, for, gender_label, rent_from_inr, rent_to_inr, rooms[]{type, code, rent_inr}, locality, locality_id, city, city_id, description, rating, image, verified} + total + page + total_pages + has_next

**Example request body:**
```json
{
  "city": "Mumbai"
}
```

### POST https://api.reefapi.com/magicbricks/v1/pg — 1 credit
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.

**Parameters:**
- `pg` (string, required) — The `url` of a pg_search row (magicbricks.com/propertyDetail/…&pgid=…).

**Returns:** pg_id, name, locality, rent_from_inr, rent_basis, rating, review_count, deposit_inr, maintenance_inr, notice_period, electricity_charges, food_availability, available_for, preferred_tenants, total_beds, operating_since, details{label: value}, sections{}

**Example request body:**
```json
{
  "pg": "https://www.magicbricks.com/propertyDetail/antilla-pg-nav-pada-in-mumbai&pgid=4d423130323433677261646531"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=magicbricks
- Human docs page: https://reefapi.com/docs/magicbricks
- Overview page: https://reefapi.com/magicbricks-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
