99acres Projects Search Scraper

Collect bounded project cards from public 99acres project-search and new-projects-in-… pages. The Actor supports multiple search URLs, global project-ID deduplication, pagination, price/area/status/configuration filters, field toggles, and optional public detail-page enrichment.

Only usable projects with a matching canonical 99acres project ID and URL are stored in the pay-per-result dataset. Verification pages, request failures, zero usable results, rejected records, and optional detail failures are reported in the OUTPUT key.

Input

• searchUrls: 1–10 unique HTTPS URLs on exactly 99acres.com; only project-search and new-project pages are accepted.
• maxItems: global cap from 1 to 500.
• maxPages: per-URL cap from 1 to 100.
• filters: optional statuses, configurations, overlapping price bounds in INR, and area bounds.
• enableDeepScraping: opens each accepted project page for additional public fields.
• includeDescription, includeHighlights, includeImages, includeAmenities, includeContact: output field controls.
• deduplicate: deduplicate by project ID across URLs and pages.
• locale, requestDelayMs, maxConcurrency, detailConcurrency, and timeout controls: bounded runtime settings.
• proxyConfiguration: optional Apify proxy configuration; the default is standard Apify Proxy.

Automatic retries default to zero. The Actor does not solve CAPTCHAs, modify browser fingerprints, rotate user agents, log proxy credentials, or fabricate missing fields.

Output

Every dataset row has explicit success semantics and provenance:

• recordType, found, dataAvailable, error
• projectId, idType, canonical projectUrl, and projectName
• optional developer, property type, location, configurations, INR price, area, status, possession, RERA, highlights, media, and details
• searchUrl, sourceDomain, pageNumber, detailScraped, and scrapedAt

OUTPUT contains the run status, counts, detail metrics, safe diagnostics, proxy mode, and explicit user-agent/fingerprint flags.

Example

{
  "searchUrls": [
    "https://www.99acres.com/search/project/buy/chennai?city=36&preference=S"
  ],
  "maxItems": 10,
  "maxPages": 2,
  "enableDeepScraping": false,
  "proxyConfiguration": { "useApifyProxy": true }
}

Development

npm ci
npm test
apify run --purge --input-file qa-inputs/local-search.json
npm run validate