Acres99 Properties and Details Scraper

This Actor is permission-gated because 99acres' current terms prohibit automated data extraction without explicit written consent. By default it makes zero source requests and reports SUCCEEDED / SKIPPED_POLICY; it does not add an authorization diagnostic to the dataset. Set authorizationConfirmed only when current written permission covers automated retrieval and the intended reuse; the checkbox is an operator attestation and does not grant permission. The Actor accepts supported public search filters and 99acres URLs once authorized.

What is returned

Each propertyListing row contains the public listing ID, headline, mode, property type, BHK/bedroom counts, bathrooms, balconies, carpet/built-up/super area, INR price and price-per-square-foot, deposit or brokerage text when visible, furnishing, floor, availability, locality/city, public coordinates, project and RERA identifiers, seller attribution, amenities, selling points, tenant preferences, public image URLs, description, and canonical listing URL. Dates are normalized to ISO 8601 when the page supplies parseable values. Missing source values are omitted instead of replaced with placeholders.

Only validated property listings with a public 99acres listing URL, identifier, title, and source provenance are written to the dataset. A blocked or failed page creates no diagnostic or placeholder row. A clean bounded search, including an empty result, reports SUCCEEDED / COMPLETED; failures without saved listings report FAILED / FAILED and exit nonzero; failures after saved listings report SUCCEEDED / PARTIAL and exit successfully. Failure details and aggregate counts are stored in the OUTPUT key-value summary.

Input example

{
  "city": "Bangalore",
  "searchMode": "rent",
  "localities": ["Koramangala"],
  "bhk": [2],
  "maxResults": 15,
  "maxPages": 2
}

For an authorized run, set authorizationConfirmed: true and use startUrls with { "url": "https://www.99acres.com/..." } when a precise page is needed. Price and area bounds are applied locally to normalized values.

Responsible use

The official terms require explicit written consent for automated access/extraction and restrict reuse of listing information. No authorization is recorded for this project. The Actor does not return gated phone numbers or private account data. Do not enable retrieval unless the operator has applicable written permission.

Project structure

• src/input.js validates and constructs public targets.
• src/http.js performs bounded public requests and classifies challenges.
• src/parser.js normalizes JSON-LD, embedded state, and card markup.
• src/run.js applies filters, de-duplicates, and writes records.
• .actor/ contains the input, output, dataset, and run-summary contracts.