commonfloor.com APIcommonfloor.com ↗
Access CommonFloor property listings, project details, market trends, amenities, nearby POIs, and agent info across Indian cities via 9 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/a6558220-8a63-4e08-ab89-73ac743af634/search_properties?city=Bangalore&page=1&listing_type=sale' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for property listings (buy/rent) in a city with optional filters. Returns paginated results. The bhk filter is a hint that may return mixed BHK values from the upstream. The locality filter uses the site's internal locality names which may not match common area names.
| Param | Type | Description |
|---|---|---|
| bhk | string | Number of bedrooms to filter by (e.g. '2', '3', '4'). Acts as a preference hint; results may include other BHK types. |
| city | string | City name. Confirmed working values: Bangalore, Mumbai, Delhi-NCR, Pune, Chennai, Hyderabad, Kolkata, Ahmedabad, Thane, Navi Mumbai, Gurgaon, Noida. |
| page | integer | Page number for pagination. |
| locality | string | Locality/area name filter. Uses the site's internal locality naming which may differ from common area names; may return empty results if the name doesn't match exactly. |
| budget_max | integer | Maximum budget in INR. |
| budget_min | integer | Minimum budget in INR. |
| listing_type | string | Type of listing: 'sale' or 'rent'. |
| property_type | string | Property type filter (e.g. 'Apartment', 'Villa', 'Plot'). |
{
"type": "object",
"fields": {
"page": "integer current page number",
"listings": "array of property listing objects with cfListingId, title, price, bhk, property_area, property_type, cfAreaName, url",
"page_size": "integer number of results per page",
"total_count": "integer total number of matching results"
},
"sample": {
"data": {
"page": 1,
"listings": [
{
"bhk": "",
"url": "/listing/plot-for-sale-in-sarjapur-road-bangalore-at-ivy-county-pristine-villa-plots/b8rs687w0vszdaww",
"price": "1.26 Cr ",
"title": "Plot for Sale in Sarjapur Road",
"cfAreaName": "Sarjapur Road",
"cfListingId": "b8rs687w0vszdaww",
"property_area": 1200,
"property_type": "Plot"
}
],
"page_size": 30,
"total_count": 39176
},
"status": "success"
}
}About the commonfloor.com API
The CommonFloor API exposes 9 endpoints covering property listings, real estate projects, market price trends, and location intelligence across major Indian cities. Use search_properties to query buy or rent listings filtered by city, BHK, budget, locality, and property type, and get_property_details to retrieve full listing data including broker info, images, and similar properties. Structured JSON responses include fields like cfListingId, carpetArea, bhk_range, and sell_trend_data.
Property Search and Listing Details
The search_properties endpoint accepts filters for city, listing_type (sale or rent), bhk, budget_min, budget_max, property_type, and locality. Results are paginated and each listing object includes cfListingId, title, price, bhk, property_area, property_type, cfAreaName, and a direct url. Note that the bhk parameter is a preference hint — the upstream data may return mixed BHK values, and locality must match CommonFloor's internal naming, which can differ from commonly used area names.
get_property_details takes a listing_id (e.g. gfv4o4uqzkjya5wm) and returns the full listing record: broker contact details via the broker object, an images.cfImages array, and a flpBodyQH object containing price, bedrooms, carpetArea, city, area_name, intent, and projectId. Similar properties are returned in the similar_listings array.
Projects, Trends, and Location Data
search_projects and get_project_details cover new residential developments. Project objects include cfBuilder_name, minimumPrice, maximumPrice, cfLocality_name, and cfProjectUrl. The get_market_trends endpoint accepts an entity_id and page_type (listing or project) and returns sell_trend_data (price per sqft over time periods) and rent_trend_data (rent values by BHK) for the entity's locality and nearby areas.
get_property_location_info returns nearby POIs organized by category — school, hospital, techPark, metroStation, and shoppingMall — each with poiName, travelDistance, and travelTime. The entity_id for this endpoint is the numeric project ID found under qaAnalyticsCf.project_id in property details, not the alphanumeric listing ID. get_property_amenities returns an array of amenity name strings for a listing, though coverage varies — some listings return an empty array. Agent contact via get_agent_contact_details exposes contact_name, contact_person_type, and propertyType; the phone number is gated and not returned.
- Aggregate buy and rent listings across Bangalore, Mumbai, and Pune with budget and BHK filters for a property comparison tool.
- Build a project discovery feed that surfaces new residential developments using search_projects with builder name and price range data.
- Display locality-level price-per-sqft trends from get_market_trends to help buyers evaluate neighborhood pricing over time.
- Enrich property detail pages with nearby school, hospital, and metro station data from get_property_location_info.
- Show available amenities like Swimming Pool, Gym, and Club House for shortlisted listings using get_property_amenities.
- Identify whether a listing is handled by a Broker or Owner using the contact_person_type field in get_agent_contact_details.
- Populate a city selector for a real estate app using the supported city list from get_cities_list.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.