# Housing.com Scraper - Indian Property Listings (`khadinakbar/housing-com-scraper`) Actor Extract public Housing.com sale and rental listings, including INR prices, BHK, area, locality, RERA, seller and media, for Indian property research. - **URL**: https://apify.com/khadinakbar/housing-com-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Real estate, Automation, MCP servers - **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 property listing returneds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Housing.com Scraper - Indian Property Listings **Housing.com Scraper** discovers public Housing.com project listings through Google's live search index and returns a clean, analysis-ready dataset. Give it one or more public Housing.com search-result or project URLs and it returns indexed project URLs, titles, prices, BHK signals, locations, developer names, public descriptions, RERA signals, and scrape time. Use it for Indian real-estate market research, comparable-property analysis, inventory monitoring, proptech workflows, and AI-agent research. It is designed for public listing data only. It does not sign in, reveal contact details, submit enquiries, or access seller dashboards. ### When to use this actor Use this actor when you need a bounded, reproducible set of listings from a known Housing.com URL. Configure the city, locality, sale/rental type, BHK, price range, or property-type filters in Housing.com first; then copy the resulting public URL into `startUrls`. This preserves the site's exact filter semantics instead of having the actor guess a locality slug. Typical uses include: - Compare current asking prices, BHK, size, and price-per-square-foot for a locality. - Monitor a saved Housing.com search for inventory changes. - Export public new-booking, resale, project, and rental listings into a property-research workflow. - Build a compact listing dataset for an AI analyst or valuation dashboard. - Enrich an existing workflow with public project, RERA, seller, and listing-media signals. Do not use it for account-only Housing.com pages, seller dashboard URLs, submitting leads, or real-estate appraisal and legal due diligence. This actor is specifically for `housing.com` public property and search pages, not other Indian portals. ### Input `startUrls` is required. Add up to 10 public Housing.com search or direct listing URLs. The default is a sale search for Mira Road East, Mumbai. `maxResults` is both a result cap and a predictable pay-per-event cap. `maxPages` bounds pagination for each supplied search URL. A direct listing page is visited once. | Field | Purpose | Default | | --- | --- | --- | | `startUrls` | Public Housing.com search or property URLs | Required | | `maxResults` | Maximum validated listings written and charged | 25 | | `maxPages` | Search pages per URL | 1 | | `includeDetails` | Return the indexed public result description when available | `false` | | `responseFormat` | `concise` or `detailed` records | `concise` | | `proxyCountry` | Legacy compatibility field; location still comes from the URL | `SG` | Start conservatively with one URL, one page, and 5–25 listings. Housing.com currently rejects direct automated page loads with its anti-bot layer, so the actor uses Apify's Google SERP proxy to discover Housing.com's publicly indexed project pages. This avoids fabricated data and returns `VALID_EMPTY` when the index has no matching project. `maxPages` is deliberately bounded at 10. #### Example input ```json { "startUrls": [ { "url": "https://housing.com/in/buy/mumbai/mira-road-east-mira-bhayandar-gid/" } ], "maxResults": 25, "maxPages": 1, "includeDetails": false, "responseFormat": "concise" } ```` For a direct project URL, use the same input shape and set `maxResults` to `1`. Detailed mode returns the indexed public description; direct detail-page enrichment is currently unavailable because Housing.com blocks that route. ### Output Each dataset item is one validated public listing. Fields remain present across runs; values are `null` when Housing.com does not display a value. | Field | Meaning | | --- | --- | | `id`, `url`, `title` | Public listing identifier, canonical URL, and heading | | `projectName`, `listingType`, `propertyType` | Project/building and public listing classification | | `priceText`, `priceInr`, `priceMaxInr` | Original price text and normalized INR range | | `bedrooms`, `areaSqft`, `averagePricePerSqft` | Core property comparison metrics | | `location`, `city`, `possessionStatus` | Public location and availability context | | `sellerName`, `sellerType` | Public broker or developer attribution | | `isRera`, `isVerified` | Public quality/compliance badges | | `highlights`, `imageUrls`, `description` | Public card/detail attributes | | `sourceUrl`, `scrapedAt` | Provenance and extraction time | Example concise item: ```json { "id": "19388476", "url": "https://housing.com/in/buy/resale/page/19388476-2-bhk-apartment-in-mira-road-east-for-rs-10990000", "title": "2 BHK Flat in Kashimira, Mira Road East", "projectName": "JP North Barcelona Wing D", "priceText": "₹1.1 Cr", "priceInr": 11000000, "bedrooms": 2, "areaSqft": 1010, "averagePricePerSqft": 10880, "location": "Kashimira, Mira Road East", "sellerName": "AS Realty", "isRera": true, "isVerified": true, "detailFetched": false } ``` The actor also writes `OUTPUT` and `RUN_SUMMARY` to the default key-value store for every terminal state. `OUTPUT` is the compact API/agent result: outcome, persisted count, warnings, and event charges. `RUN_SUMMARY` adds discovery-page counts, duplicate/validation counts, Google SERP diagnostics, and the pinned build/run metadata. ### Pricing This actor uses **Pay per event + platform usage**. It charges: | Event | Price | | --- | ---: | | Actor start | $0.00005 once per run | | Validated listing returned | $0.005 per dataset row | Apify platform compute and Google SERP proxy usage are charged separately under the Pay per event + usage model. No listing is charged until it has passed schema validation and is written to the default dataset. `maxResults` is your event-charge cap: a 25-result run has at most `$0.12505` in event charges, plus platform usage. ### API examples #### JavaScript ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('khadinakbar/housing-com-scraper').call({ startUrls: [{ url: 'https://housing.com/in/buy/mumbai/mira-road-east-mira-bhayandar-gid/' }], maxResults: 10, maxPages: 1, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("khadinakbar/housing-com-scraper").call(run_input={ "startUrls": [{"url": "https://housing.com/in/buy/mumbai/mira-road-east-mira-bhayandar-gid/"}], "maxResults": 10, "maxPages": 1, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["title"], item["priceInr"]) ``` ### Reliability and limits Housing.com or Google may alter indexed result availability or search markup. This actor validates every indexed Housing project row and reports an honest `UPSTREAM_FAILED` outcome if discovery itself is unavailable. If some rows are saved before a recoverable error, the run finishes as `PARTIAL` with warnings in `RUN_SUMMARY`. A valid query with no indexed projects finishes as `VALID_EMPTY`. The output is project-discovery data, not a complete live inventory feed. Fields not present in Google's indexed title or description remain `null`; `detailFetched` remains `false`, and direct contact details or private seller data are never returned. The result set represents advertised public listing data at scrape time, not a guaranteed availability, valuation, ownership, or regulatory record. Prices may be ranges or human-readable values; `priceText` retains the original displayed text alongside normalized INR fields. ### Related workflows For owner/contact enrichment after you have a lawful property address list, use a separate, jurisdiction-appropriate property-owner workflow. Keep listing collection separate from private contact enrichment so each dataset has a clear provenance and billing contract. ### Legal and responsible use This actor collects only publicly available Housing.com page data. You are responsible for using the output lawfully and in accordance with applicable data-protection, real-estate, advertising, contract, and anti-spam obligations. Do not use this actor to access private content, bypass authentication, or make decisions that require professional property, legal, or financial advice. Housing.com is a trademark of its respective owner; this actor is not affiliated with or endorsed by Housing.com. # Actor input Schema ## `startUrls` (type: `array`): Use this when you have a public Housing.com sale, rental, project, resale, or property URL with the exact filters you need. Pass URL objects such as {"url":"https://housing.com/in/buy/mumbai/mira-road-east-mira-bhayandar-gid/"}. The actor accepts at most 10 URLs and follows only housing.com pages. This is not a generic website URL field or a seller.housing.com URL. ## `maxResults` (type: `integer`): Use this to cap validated listing records saved to the dataset. Enter a whole number such as 25; the default is 25 and the maximum is 250. Each persisted listing costs $0.005, so this is also the event-charge cap. This is not a Housing.com page count. ## `maxPages` (type: `integer`): Use this to bound pagination for each supplied Housing.com search URL. Enter a whole number from 1 to 10; the default is 1. The actor stops earlier when maxResults is reached or the site yields no new listings. This does not make a direct listing page repeat. ## `includeDetails` (type: `boolean`): Use this to include the public description shown in Google's indexed Housing.com result. Direct Housing.com detail pages are currently blocked, so this option does not fetch extra media or private fields. ## `responseFormat` (type: `string`): Use this to choose concise or detailed listing records for an AI workflow or export. Select concise for the core market-comparison fields or detailed for public descriptions and extra media; the default is concise. This does not remove listing ID, URL, title, price, BHK, area, location, seller, or scrape time. ## `proxyCountry` (type: `string`): Retained for backwards compatibility. Current builds use Apify's Google SERP proxy and do not route discovery by this value. Set the Housing.com city or locality in the supplied public URL. ## Actor input object example ```json { "startUrls": [ { "url": "https://housing.com/in/buy/mumbai/mira-road-east-mira-bhayandar-gid/" } ], "maxResults": 25, "maxPages": 2, "includeDetails": false, "responseFormat": "concise", "proxyCountry": "IN" } ``` # Actor output Schema ## `listings` (type: `string`): Structured public Housing.com property listings. ## `output` (type: `string`): Compact machine-readable terminal outcome and item count. ## `runSummary` (type: `string`): Detailed run diagnostics with page, parsing, and billing counters. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://housing.com/in/buy/mumbai/mira-road-east-mira-bhayandar-gid/" } ], "maxResults": 25, "maxPages": 1, "includeDetails": false, "responseFormat": "concise", "proxyCountry": "SG" }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/housing-com-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://housing.com/in/buy/mumbai/mira-road-east-mira-bhayandar-gid/" }], "maxResults": 25, "maxPages": 1, "includeDetails": False, "responseFormat": "concise", "proxyCountry": "SG", } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/housing-com-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://housing.com/in/buy/mumbai/mira-road-east-mira-bhayandar-gid/" } ], "maxResults": 25, "maxPages": 1, "includeDetails": false, "responseFormat": "concise", "proxyCountry": "SG" }' | apify call khadinakbar/housing-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/housing-com-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Housing.com Scraper - Indian Property Listings", "description": "Extract public Housing.com sale and rental listings, including INR prices, BHK, area, locality, RERA, seller and media, for Indian property research.", "version": "1.0", "x-build-id": "Ep514fS0t1eGmSeXr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~housing-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-housing-com-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/khadinakbar~housing-com-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-housing-com-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/khadinakbar~housing-com-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-housing-com-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Housing.com search or listing URLs", "type": "array", "description": "Use this when you have a public Housing.com sale, rental, project, resale, or property URL with the exact filters you need. Pass URL objects such as {\"url\":\"https://housing.com/in/buy/mumbai/mira-road-east-mira-bhayandar-gid/\"}. The actor accepts at most 10 URLs and follows only housing.com pages. This is not a generic website URL field or a seller.housing.com URL.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Maximum listings", "minimum": 1, "maximum": 250, "type": "integer", "description": "Use this to cap validated listing records saved to the dataset. Enter a whole number such as 25; the default is 25 and the maximum is 250. Each persisted listing costs $0.005, so this is also the event-charge cap. This is not a Housing.com page count.", "default": 25 }, "maxPages": { "title": "Maximum pages per search URL", "minimum": 1, "maximum": 10, "type": "integer", "description": "Use this to bound pagination for each supplied Housing.com search URL. Enter a whole number from 1 to 10; the default is 1. The actor stops earlier when maxResults is reached or the site yields no new listings. This does not make a direct listing page repeat.", "default": 1 }, "includeDetails": { "title": "Include listing detail pages", "type": "boolean", "description": "Use this to include the public description shown in Google's indexed Housing.com result. Direct Housing.com detail pages are currently blocked, so this option does not fetch extra media or private fields.", "default": false }, "responseFormat": { "title": "Response format", "enum": [ "concise", "detailed" ], "type": "string", "description": "Use this to choose concise or detailed listing records for an AI workflow or export. Select concise for the core market-comparison fields or detailed for public descriptions and extra media; the default is concise. This does not remove listing ID, URL, title, price, BHK, area, location, seller, or scrape time.", "default": "concise" }, "proxyCountry": { "title": "Legacy proxy-country setting", "enum": [ "IN", "SG", "GB", "US" ], "type": "string", "description": "Retained for backwards compatibility. Current builds use Apify's Google SERP proxy and do not route discovery by this value. Set the Housing.com city or locality in the supplied public URL.", "default": "SG" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```