Housing.com Property Search API Search homes for sale or for rent in an Indian city or locality. Filter by price, area, bedrooms, property type, furnishing (rent), seller type and listing age, sort and page through the results. Each row has the price with fees, area, rooms, address and coordinates, images, per-size configurations of projects, features and the sellers with masked phone numbers. Housing.com applies every filter and each row is checked again against your filters. A row is dropped only when its own data contradicts a filter; the number of dropped rows is in meta.rows_removed_by_guard, so a page can hold fewer than 30 rows. A project card matches when one of its sizes matches all your filters together. A half size such as 2.5 BHK is not counted as 2 BHK or 3 BHK. total_count is the count reported by Housing.com before this check. Pages hold 30 rows; some rows can repeat on a later page because Housing.com mixes promoted projects into pages; a response never repeats a listing. A page beyond the last returns an empty list with the true total_count. The first search for a locality can take a little longer.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
2 required parameters needed before sending a request.
14 optional filters available.
string
Required
buy or rent.
example
string
Required
City name or id from the cities endpoint, e.g. Mumbai.
example
string
Optional
Place text, e.g. powai. The best matching locality is used. Leave out for a whole city. Do not send together with canonical.
Austin, Texas
string
Optional
Place path from the autocomplete endpoint, e.g. /in/buy/mumbai/powai-gid/. Skips the place lookup.
example
integer
Optional
Minimum price in INR (rent per month for rent).
10
integer
Optional
Maximum price in INR.
10
integer
Optional
Minimum built-up area in sq ft.
10
integer
Optional
Maximum built-up area in sq ft.
10
string
Optional
Comma separated list of 1rk, 1, 2, 3, 4, 5, 5+.
example
string
Optional
Comma separated list of apartment, independent_house, independent_floor, studio, duplex, penthouse, villa.
example
string
Optional
Rent only. Comma separated list of fully, semi, unfurnished.
example
string
Optional
Comma separated list of agent, owner, developer.
example
integer
Optional
Listed within the last 1, 2, 7, 14, 30 or 60 days.
10
string
Optional
relevance (default), price, date_added, price_per_sqft or updated_at.
relevance
string
Optional
asc or desc. Default asc for price and price_per_sqft, desc for the others. date_added and updated_at support desc only.
example
integer
Optional
Page number, 1 or more. Every page holds up to 30 rows. Default 1.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"city": "Mumbai",
"page": 1,
"size": 30,
"count": 1,
"service": "buy",
"has_more": true,
"listings": [
{
"url": "https://housing.com/in/buy/projects/page/327036-kanakia-silicon-valley-by-kanakia-spaces-realty-in-powai",
"area": {
"unit": "sq.ft",
"display": "429 sq.ft",
"built_up": 429
},
"tags": [
"rera_verified"
],
"type": "project",
"badge": null,
"label": null,
"price": {
"max": 67373208,
"min": 16991832,
"unit": null,
"amount": 16991832,
"deposit": null,
"display": "\u20b92.3 Cr - 3.3 Cr",
"currency": "INR",
"brokerage": 0,
"total_rent": null,
"maintenance": null,
"lock_in_period": null,
"deposit_display": null,
"brokerage_display": null,
"maintenance_display": null
},
"title": "Kanakia Silicon Valley",
"images": [
"https://is1-3.housingcdn.com/4f2250e8/c1c152bca99d5f64bb6f2a597949e048/v0/version/kanakia_silicon_valley-powai-mumbai-kanakia_spaces_realty.jpeg",
"https://img.youtube.com/vi/tWpILrLvHNQ/hqdefault.jpg",
"https://is1-3.housingcdn.com/012c1500/116c162b9456f6db07ee14328f37b497/v0/version.jpeg"
],
"parking": null,
"sellers": [
{
"id": "2b97e43d-627a-401f-a8f1-6ee13f6d1db1",
"firm": null,
"name": "Investorealty",
"type": "Seller",
"badge": null,
"image": null,
"is_paid": true,
"designation": "Seller",
"is_certified": null,
"phone_masked": "91671.....",
"listings_hash": "A3try8d5ls1s3wjvje62gmnqup",
"customers_served": null
}
],
"bedrooms": 1,
"features": [
{
"id": "configs",
"label": "Configurations",
"value": "1, 2, 3, 4 BHK Flats"
},
{
"id": "possession",
"label": "Possession Starts",
"value": "Dec, 2026"
},
{
"id": "avgPrice",
"label": "Avg. Price",
"value": "\u20b939.61 K/sq.ft"
}
],
"insights": [
{
"id": "possession",
"label": null,
"value": "Under Construction"
},
{
"id": "apartments",
"label": null,
"value": "2 BHK Flat"
}
],
"location": {
"city": {
"id": "1ca99c33e3d8b987ccf1",
"name": "Mumbai",
"slug": "mumbai"
},
"state": {
"id": "82b2a9c2e9b437c9ffdc",
"name": "Maharashtra",
"slug": "maharashtra"
},
"region": {
"id": "7318a08bb6570a26e893",
"name": "Mumbai Metropolitan Region",
"slug": "mmr"
},
"address": "Powai, Mumbai",
"latitude": 19.127806,
"locality": {
"id": "dce9290ec3fe8834a293",
"name": "Powai",
"slug": "powai"
},
"longitude": 72.893547,
"sublocality": {
"id": "c67b3645cc67d027e471",
"name": "Krishna Nagar",
"slug": "krishna_nagar_powai"
},
"address_parts": []
},
"subtitle": "2 BHK Flat",
"bathrooms": null,
"is_active": true,
"posted_at": "2024-07-18T14:47:48Z",
"developers": [
{
"url": "https://housing.com/buy-projects-by-kanakia-spaces-realty-bid-107425-Ajgtjbdaj3uula1zc0zcub5il3",
"name": "Kanakia Spaces Realty",
"image": "https://is1-3.housingcdn.com/0b8ad14c/26941fdee374cc1420ccd3c67bc5148f/v1/version.jpg"
}
],
"furnishing": null,
"highlights": [],
"listing_id": "327036",
"updated_at": "2026-04-07T00:30:06.000Z",
"cover_image": {
"alt": "Gallery Cover Pic of Kanakia Silicon Valley",
"url": "https://is1-3.housingcdn.com/4f2250e8/c1c152bca99d5f64bb6f2a597949e048/v0/version/kanakia_silicon_valley-powai-mumbai-kanakia_spaces_realty.jpeg"
},
"description": null,
"emi_display": "\u20b984.36 K",
"image_count": 37,
"is_verified": null,
"verified_at": null,
"brochure_url": "https://housing-is-01.s3.ap-southeast-1.amazonaws.com/6a32315a/2a534e6becfc3b6999cd184575c00717/original.pdf",
"is_certified": null,
"nearby_places": [
{
"name": "Bombay Scottish School, Powai",
"type": "school",
"distance_km": 1.07
},
{
"name": "Goregaon Check Naka No 3 Bus Stop",
"type": "bus_station",
"distance_km": 1.08
}
],
"review_rating": null,
"configurations": [
{
"area": 429,
"label": "1 BHK Apartment",
"price": 16991832,
"area_type": "Carpet Area",
"area_unit": "sq.ft",
"rera_status": "Rera",
"price_display": "\u20b9 1.7 Cr",
"property_type": "Apartment"
},
{
"area": 589,
"label": "2 BHK Apartment",
"price": 23329112,
"area_type": "Carpet Area",
"area_unit": "sq.ft",
"rera_status": "Rera",
"price_display": "\u20b9 2.33 Cr",
"property_type": "Apartment"
}
],
"digital_tour_url": null,
"possession_status": "Under Construction",
"original_listing_id": "327036",
"is_under_construction": true
}
],
"location": "Powai, Mumbai",
"total_count": 428,
"filters_applied": {
"size": 30,
"sort": "price",
"order": "desc",
"bedrooms": [
"2"
],
"location": "powai",
"price_max": 30000000
}
},
"meta": {
"billable": true,
"endpoint_family": "search",
"duplicates_removed": 0,
"rows_removed_by_guard": 0
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter is missing or invalid. This response is not billable.
{
"errors": {
"city": [
"A city is required, e.g. Mumbai. Use the cities endpoint for the list."
]
},
"message": "The request validation failed"
}Not Found
The city or the place was not found. This response is not billable.
{
"meta": {
"attempts": 1,
"billable": false,
"retryable": false
},
"error": {
"message": "No Housing.com location matches this city and place. Check the city and use autocomplete for the place.",
"failure_type": "location_not_found"
},
"success": false
}Temporarily Unavailable
Housing.com did not answer or refused the request after several attempts. This response is not billable. Retry after a short pause.
{
"meta": {
"attempts": 3,
"billable": false,
"retryable": true
},
"error": {
"message": "Housing.com data is temporarily unavailable. Please retry.",
"failure_type": "upstream_timeout"
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.