Housing.com Property Search Scraper

Extract compact public sale and rental property listings from Housing.com search pages. The Actor reads structured SEARCH_RESULTS responses when available and falls back to public page state and property-card links.

Input

Field	Type	Default	Description
searchUrls	string[]	required	One through 10 HTTPS search URLs on housing.com or www.housing.com.
maxCrawlPerSearch	integer	20	Per-search record cap, from 1 through 100.
maxItems	integer	20	Total unique record cap, from 1 through 200.
proxyConfiguration	object	direct	Optional Apify or custom proxy configuration.
includeSourceEvidence	boolean	false	Retain public initial HTML and search-response evidence in the key-value store.

Example:

{
  "searchUrls": ["https://housing.com/in/rent/mumbai"],
  "maxCrawlPerSearch": 20,
  "maxItems": 20,
  "proxyConfiguration": { "useApifyProxy": false }
}

Direct access is the default. A proxy can be explicitly configured at the start of a run; no residential traffic is purchased implicitly. An HTTP failure, protection page or required login stops the run without retries or switching network paths. Unknown fields, off-domain URLs, type coercion, and excessive limits fail before browser startup.

Output

Each dataset item is a unique public property and includes a stable listing ID and URL, title, type and status, pricing and area information, bedrooms/bathrooms/parking, public location coordinates and labels, media counts, available features/tags, listing flags, timestamps, source search URL, and scrape timestamp.

Empty optional values are removed while zero and false are preserved. The compact dataset omits seller/contact arrays, cookies and authentication data. Valid records from earlier search URLs are retained if a later search fails, with status: "partial", success: false and a nonzero exit code. No-results runs also exit nonzero.

With includeSourceEvidence: true, the Actor stores SOURCE_EVIDENCE_0001-style JSON envelopes containing rawBody, sha256, url, status, kind, searchUrl and capturedAt. Initial HTML is saved before page-state parsing, including HTTP-denial responses when available. Accepted public SEARCH_RESULTS responses are saved before JSON parsing. A row includes sourceEvidenceKey when its structured response, or exact title and URL in initial HTML, can be identified. Evidence can include public listing details absent from the compact dataset; it never includes request headers, proxy credentials or cookies. Credentialed URLs and authentication endpoints are excluded. Bodies containing recognizable credential-like fields are omitted; their envelopes retain only metadata and a hash with bodyOmittedReason, and rows do not link to those omitted bodies.

The OUTPUT and OUTPUT_SUMMARY key-value records contain the final record count, requested and attempted search URL counts, failures, Actor duration, and sourceEvidenceCount / sourceEvidenceKeys. Evidence is disabled by default.

Responsible use

Collect only public data you are permitted to process. Respect Housing.com's terms, applicable privacy law, and reasonable request rates. This Actor does not authenticate, bypass CAPTCHA or spoof browser fingerprints. Its ordinary Chrome launch matches the pinned Docker image. Review public source evidence before sharing it.