# Housing Property Search Scraper (`ecomscrape/housing-property-search-scraper`) Actor

The Housing.com Property Search Scraper extracts property information from Housing.com. Capture data such as price, address, features, and coordinates by providing Property Search Query URLs.

- **URL**: https://apify.com/ecomscrape/housing-property-search-scraper.md
- **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community)
- **Categories:** Real estate, Developer tools, Automation
- **Stats:** 106 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)

**Housing.com Property Data Extraction Made Simple**

### Introduction

Housing.com stands as one of India's most visited real estate platforms, hosting over 650,000 mapped properties across the country. For real estate professionals, market researchers, and property investors, accessing this vast database of property information can provide invaluable insights into market trends, pricing patterns, and available inventory. However, manually collecting this data from thousands of property listings is time-consuming and inefficient.

The Housing.com Property Search Scraper addresses this challenge by automating the data extraction process from Housing.com's property search results. This tool enables users to gather comprehensive property information at scale, transforming hours of manual work into minutes of automated data collection.

### Overview of the Housing.com Scraper

The Housing.com Property Search Scraper is a sophisticated data extraction tool designed specifically for Housing.com's property listing pages. It efficiently navigates through property search results and extracts detailed information about residential and commercial properties across India.

This scraper excels in handling Housing.com's dynamic content structure, ensuring reliable data extraction even as the website's layout evolves. The tool includes built-in retry mechanisms and proxy support to maintain consistent performance while respecting the website's access policies.

The primary users of this scraper include real estate agents seeking market intelligence, property investment firms conducting due diligence, market researchers analyzing housing trends, and data analysts building comprehensive property databases for various business applications.

### Input and Output Details

Example url 1: https://housing.com/in/buy/projects/goregaon_east?page=3

Example url 2:  https://housing.com/in/buy/gurgaon/gurgaon

Example url 3: https://housing.com/in/buy/real-estate-thane

Example Screenshot of property list by query page:

![](https://i.ibb.co/C8vBwYV/Screenshot-from-2025-01-13-12-42-38.png)

#### Input Format

The scraper accepts a JSON configuration that specifies the extraction parameters and target URLs. The input structure includes several key components:

```json
{
  "max_retries_per_url": 2, // Maximum waiting time when accessing the links you provided.
  "proxy": { // Add a proxy to ensure that during the data collection process, you are not detected as a bot.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "SG" // You should choose an Country that coincides with the Country you want to collect data from
  },
  "max_items_per_url": 20,
  "urls": [ // Links to property list by query pages.
    "https://housing.com/in/buy/projects/goregaon_east?page=3",
    "https://housing.com/in/buy/gurgaon/gurgaon",
    "https://housing.com/in/buy/real-estate-thane"
  ]
}
```

**Configuration Parameters:**

- `max_retries_per_url`: Controls the maximum number of retry attempts for each URL (recommended: 2-3)
- `max_items_per_url`: Limits the number of properties extracted per page (default: 20)
- `proxy`: Configures proxy settings to avoid detection, with options for residential proxies and country selection

**URL Requirements:**
The `urls` array should contain Housing.com property search result pages.

#### Output Format

You get the output from the Housing.com Property Search Scraper stored in a tab. The following is an example of the Information Fields collected after running the Actor.

```json
[ // List of property information
  {
    "id": "253195",
    "url": "/in/buy/projects/page/253195-rachaita-aarambh-by-rachaita-developers-in-goregaon-east",
    "name": "Rachaita Aarambh",
    "subtitle": "1 RK, 1, 2 BHK Flats",
    "image_url": "https://is1-2.housingcdn.com/4f2250e8/e54f2d7c1374e5b0b609a333f9f6f120/v0/version/rachaita_aarambh-goregaon_east-mumbai-rachaita_developers.jpeg",
    "polygons_hash": {
      "h_district": {
        "url_name": null,
        "name": null,
        "display_name": null,
        "uuid": null
      },
      "city": {
        "url_name": "mumbai",
        "name": "Mumbai",
        "display_name": [
          "Mumbai",
          "Maharashtra"
        ],
        "uuid": "1ca99c33e3d8b987ccf1"
      },
      "neighbourhood": {
        "url_name": null,
        "name": null,
        "display_name": null,
        "uuid": null
      },
      "housing_region": {
        "url_name": "andheri_dahisar",
        "name": "Andheri - Dahisar",
        "display_name": [
          "Andheri - Dahisar",
          "Mumbai"
        ],
        "uuid": "c81936bdf7593bb711dc"
      },
      "locality": {
        "url_name": "goregaon_east",
        "name": "Goregaon East",
        "display_name": [
          "Goregaon East",
          "Mumbai"
        ],
        "uuid": "e986d151d562723d4031"
      },
      "sublocality": {
        "url_name": "sonawala_industry_estate",
        "name": "Sonawala Industry Estate",
        "display_name": [
          "Sonawala Industry Estate",
          "Goregaon East",
          "Mumbai"
        ],
        "uuid": "e24c20c856c8c5552931"
      },
      "state": {
        "url_name": "maharashtra",
        "name": "Maharashtra",
        "display_name": null,
        "uuid": "82b2a9c2e9b437c9ffdc"
      },
      "region": {
        "url_name": "mmr",
        "name": "Mumbai Metropolitan Region",
        "display_name": [
          "MMR",
          "Maharashtra"
        ],
        "uuid": "7318a08bb6570a26e893"
      },
      "housing_state": {
        "url_name": null,
        "name": null,
        "display_name": null,
        "uuid": null
      }
    },
    "current_possession_status": "Ready to Move",
    "is_active_property": true,
    "is_most_contacted": false,
    "features": [
      {
        "label": "Configurations",
        "description": "1 RK, 1, 2 BHK Flats",
        "id": "configs"
      },
      {
        "label": "Possession Starts",
        "description": "Sep, 2024",
        "id": "possession"
      },
      {
        "label": "Avg. Price",
        "description": "₹29.62 K/sq.ft",
        "id": "avgPrice"
      }
    ],
    "min_price": 6159983.0,
    "max_price": 19123910.0,
    "currency": "₹",
    "price_display_value": "₹61.6 L - 1.91 Cr",
    "address": {
      "address": "Goregaon East, Andheri - Dahisar, Mumbai",
      "url": null,
      "detailedPropertyAddress": [
        {
          "url": "/in/buy/projects/sonawala_industry_estate",
          "val": "Sonawala Industry Estate, Goregaon East,Mumbai"
        }
      ],
      "distanceFromEntity": null,
      "longAddress": "Aarey Road, Goregaon West, Andheri - Dahisar, Mumbai"
    },
    "posted_date": "2020-12-10T17:36:06Z",
    "promotions": [],
    "custom_offers": [],
    "suggested_offers": [],
    "coords": [
      "19.159391",
      "72.852005"
    ],
    "property_information": {
      "bedrooms": 1,
      "bathrooms": null,
      "parking": null,
      "area": "208 sq.ft",
      "price": "61.6 L"
    },
    "seller": [
      {
        "name": "Rachaita Developers",
        "id": "1faacc35-338e-461c-956f-90a14af64ea7",
        "image": null,
        "firmName": null,
        "url": "/buy-projects-by-rachaita-developers-bid-4575726-A2s30o34rk1y3iw8lxm2jtvzjb",
        "type": "Developer",
        "isPrime": false,
        "sellerBadge": null,
        "isPaid": false,
        "designation": "Developer",
        "formattedCustomerServedCount": null,
        "phone": {
          "partialValue": "98200....."
        },
        "isCertifiedAgent": null,
        "sellerTag": null,
        "adDeficit": 0,
        "meta": {
          "primaryTags": [],
          "secondaryTags": [],
          "paid": false,
          "adDeficit": 0,
          "priceRange": "₹ 61.6 L - 1.91 Cr"
        },
        "contactPersonId": 3
      }
    ],
    "emi": "₹32.62 K",
    "brands": [
      {
        "name": "Rachaita Developers",
        "image": null,
        "theme": null,
        "url": "/buy-projects-by-rachaita-developers-bid-4575726-A2s30o34rk1y3iw8lxm2jtvzjb"
      }
    ],
    "details": {
      "sliceViewUrl": null,
      "images": [
        {
          "type": "property",
          "images": [
            {
              "src": "https://is1-2.housingcdn.com/4f2250e8/e54f2d7c1374e5b0b609a333f9f6f120/v0/version/rachaita_aarambh-goregaon_east-mumbai-rachaita_developers.jpeg",
              "alt": null,
              "aspectRatio": null,
              "isSvOrDcVerified": null,
              "category": "Project Images",
              "caption": "Project Images",
              "tag": "Project Images",
              "type": "image"
            },
            {
              "src": "https://is1-3.housingcdn.com/012c1500/9e3ca227f5b966bf30ca23c95c1ed854/v0/version.png",
              "alt": "Project Image of 207.96 - 645.62 Sq.ft 1 RK Apartment for buy in Rachaita Aarambh",
              "aspectRatio": 1.35,
              "isSvOrDcVerified": false,
              "category": "Amenities",
              "caption": "Others",
              "tag": "Project Images",
              "type": "image"
            },
            {
              "src": "https://is1-3.housingcdn.com/012c1500/5b637396149e261eeb58df49f1629e63/v0/version.png",
              "alt": "Project Image of 207.96 - 645.62 Sq.ft 1 RK Apartment for buy in Rachaita Aarambh",
              "aspectRatio": 1.5037593984962405,
              "isSvOrDcVerified": false,
              "category": "Bedroom",
              "caption": "Bedroom",
              "tag": "Bedroom",
              "type": "image"
            },
            {
              "src": "https://is1-3.housingcdn.com/012c1500/bb63d8bedb3ed4a10109f4dcdc321c75/v0/version.png",
              "alt": "Project Image of 207.96 - 645.62 Sq.ft 1 RK Apartment for buy in Rachaita Aarambh",
              "aspectRatio": 1.5037593984962405,
              "isSvOrDcVerified": false,
              "category": "Living Area",
              "caption": "Living Area",
              "tag": "Living Area",
              "type": "image"
            },
            {
              "src": "https://is1-2.housingcdn.com/012c1500/beb386946d3e185ca09747115aa4fb52/v0/version.png",
              "alt": "Project Image of 207.96 - 645.62 Sq.ft 1 RK Apartment for buy in Rachaita Aarambh",
              "aspectRatio": 1.5037593984962405,
              "isSvOrDcVerified": false,
              "category": "Dining Area",
              "caption": "Dining Area",
              "tag": "Dining Area",
              "type": "image"
            },
            {
              "src": "https://is1-3.housingcdn.com/012c1500/ca635a9713639f0243a860eee6c8bacf/v0/version.png",
              "alt": "Project Image of 207.96 - 645.62 Sq.ft 1 RK Apartment for buy in Rachaita Aarambh",
              "aspectRatio": 1.5037593984962405,
              "isSvOrDcVerified": false,
              "category": "Elevation",
              "caption": "Elevation",
              "tag": "Project Images",
              "type": "image"
            },
            {
              "src": "https://is1-3.housingcdn.com/012c1500/cf6b3f0a328d1ad1ca5a937f1a367780/v0/version.png",
              "alt": "Project Image of 207.96 - 645.62 Sq.ft 1 RK Apartment for buy in Rachaita Aarambh",
              "aspectRatio": 1.5037593984962405,
              "isSvOrDcVerified": false,
              "category": "Kitchen",
              "caption": "Kitchen",
              "tag": "Kitchen",
              "type": "image"
            },
            {
              "src": "https://is1-2.housingcdn.com/012c1500/d1d08b9c13785397b252e03a83b5dbdf/v0/version.png",
              "alt": "Project Image of 207.96 - 645.62 Sq.ft 1 RK Apartment for buy in Rachaita Aarambh",
              "aspectRatio": 1.5037593984962405,
              "isSvOrDcVerified": false,
              "category": "Bathroom",
              "caption": "Bathroom",
              "tag": "Bathroom",
              "type": "image"
            },
            {
              "src": "https://is1-2.housingcdn.com/012c1500/e0aaeae0c4615e3817baec847fcfe643/v0/version.png",
              "alt": "Project Image of 207.96 - 645.62 Sq.ft 1 RK Apartment for buy in Rachaita Aarambh",
              "aspectRatio": 1.5037593984962405,
              "isSvOrDcVerified": false,
              "category": "Bedroom",
              "caption": "Bedroom",
              "tag": "Bedroom",
              "type": "image"
            }
          ]
        },
        {
          "type": "locality",
          "images": []
        },
        {
          "type": "floorPlan",
          "images": []
        }
      ],
      "config": {
        "displayAreaType": "Carpet Area",
        "propertyConfig": [
          {
            "key": "1",
            "label": "1 RK",
            "propertyTypeName": "Apartment",
            "data": [
              {
                "id": "801162",
                "price": {
                  "value": 6159983,
                  "displayValue": "₹ 61.6 L",
                  "unit": null
                },
                "areaConfig": [
                  {
                    "name": "Carpet Area",
                    "areaInfo": {
                      "value": 208,
                      "unit": "sq.ft",
                      "displayArea": "208"
                    }
                  }
                ],
                "projectAttributes": {
                  "reraIdStatus": "Rera"
                }
              }
            ]
          },
          {
            "key": "2",
            "label": "1 BHK",
            "propertyTypeName": "Apartment",
            "data": [
              {
                "id": "801163",
                "price": {
                  "value": 7406731,
                  "displayValue": "₹ 74.07 L",
                  "unit": null
                },
                "areaConfig": [
                  {
                    "name": "Carpet Area",
                    "areaInfo": {
                      "value": 250,
                      "unit": "sq.ft",
                      "displayArea": "250"
                    }
                  }
                ],
                "projectAttributes": {
                  "reraIdStatus": "Rera"
                }
              },
              {
                "id": "1153074",
                "price": {
                  "value": 11344250,
                  "displayValue": "₹ 1.13 Cr",
                  "unit": null
                },
                "areaConfig": [
                  {
                    "name": "Carpet Area",
                    "areaInfo": {
                      "value": 383,
                      "unit": "sq.ft",
                      "displayArea": "383"
                    }
                  }
                ],
                "projectAttributes": {
                  "reraIdStatus": "Rera"
                }
              },
              {
                "id": "801164",
                "price": {
                  "value": 12495322,
                  "displayValue": "₹ 1.25 Cr",
                  "unit": null
                },
                "areaConfig": [
                  {
                    "name": "Carpet Area",
                    "areaInfo": {
                      "value": 422,
                      "unit": "sq.ft",
                      "displayArea": "422"
                    }
                  }
                ],
                "projectAttributes": {
                  "reraIdStatus": "Rera"
                }
              }
            ]
          },
          {
            "key": "3",
            "label": "2 BHK",
            "propertyTypeName": "Apartment",
            "data": [
              {
                "id": "801165",
                "price": {
                  "value": 19123910,
                  "displayValue": "₹ 1.91 Cr",
                  "unit": null
                },
                "areaConfig": [
                  {
                    "name": "Carpet Area",
                    "areaInfo": {
                      "value": 646,
                      "unit": "sq.ft",
                      "displayArea": "646"
                    }
                  }
                ],
                "projectAttributes": {
                  "reraIdStatus": "Rera"
                }
              }
            ]
          }
        ]
      },
      "propertyConfigs": [
        {
          "id": "possessionDate",
          "icon": "possessionDate",
          "label": "Possession Date",
          "description": "Sep, 2024",
          "meta": null,
          "showOnMobile": true,
          "mobileLabel": "possession",
          "formattedDescription": null
        },
        {
          "id": "avgPrice",
          "icon": "avgPrice",
          "label": "Average Price",
          "description": "₹29.61 K/sq.ft",
          "meta": null,
          "showOnMobile": true,
          "mobileLabel": null,
          "formattedDescription": null
        },
        {
          "id": "current_status",
          "icon": "possession",
          "label": "Possession Status",
          "description": "Ready to Move",
          "meta": null,
          "showOnMobile": true,
          "mobileLabel": null,
          "formattedDescription": null
        },
        {
          "id": "sizes",
          "icon": "carpetArea",
          "label": "Sizes",
          "description": "208 - 646 sq.ft.",
          "meta": null,
          "showOnMobile": true,
          "mobileLabel": "Sizes",
          "formattedDescription": null
        },
        {
          "id": "location",
          "icon": "location",
          "label": "Locality",
          "description": "Sonawala Industry Estate, Goregaon East,Mumbai",
          "meta": {
            "url": "/in/buy/projects/sonawala_industry_estate"
          },
          "showOnMobile": false,
          "mobileLabel": null,
          "formattedDescription": null
        }
      ],
      "brochure": {
        "pdf": null,
        "name": "Rachaita Aarambh Brochure",
        "hasBrochure": false
      }
    },
    "property_tags": [
      "Ready to Move",
      "Project",
      "RERA Approved"
    ],
    "description": "Check out this residential project for sale by Rachaita Developers in Goregaon East, Mumbai. Rachaita Aarambh offers Apartment as property type. The project has been developed in an area of 0.17 Acres . It is currently Under Construction. Available configurations include 1 RK, 1 BHK, 2 BHK. As per the area plan, units are in the size range of 208.0 - 646.0 sq.ft.. Rachaita Aarambh was launched in December 2020. Rachaita Aarambh possession is Mar, 2024. Altogether, there are 25 units available. There is 1 building in this property. The address of Rachaita Aarambh is Aarey Road, Goregaon West.<br><br>Some other provisions include access to Storm Water Drains, Sewage Treatment Plant, There is provision for Open Car Parking, Closed Car Parking. Come home to Rachaita Aarambh.<br><br>Rachaita Aarambh is approved by the state regulatory authority and the RERA ID is P51800027388.<br><br>Rachaita Developers is a renowned developer firm.<br><br>Goregaon East is a prime area, with many attractions work and recreational options just a drive away.<br><br>",
    "video_tours": null,
    "highlights": [],
    "near_by_places": [
      {
        "establishmentType": "school",
        "name": "Mount Mary High School",
        "distance": 0.38283532372363893,
        "travelDistance": 3.622,
        "duration": 6
      },
      {
        "establishmentType": "hospital",
        "name": "SRV Hospitals - Goregaon",
        "distance": 0.297567509151118,
        "travelDistance": 3.871,
        "duration": 6
      },
      {
        "establishmentType": "restaurant",
        "name": "Hotel Sai Kripa",
        "distance": 0.5466482499645111,
        "travelDistance": 4.171,
        "duration": 6
      },
      {
        "establishmentType": "shopping_mall",
        "name": "Hub Mall",
        "distance": 0.6730132582689993,
        "travelDistance": 1.554,
        "duration": 3
      },
      {
        "establishmentType": "bus_station",
        "name": "Goregaon Bus Station (W)",
        "distance": 0.5524454213589286,
        "travelDistance": 4.178,
        "duration": 6
      }
    ],
    "insights": [
      {
        "id": "possession",
        "value": "Ready to Move"
      },
      {
        "id": "apartments",
        "value": "1 RK, 1, 2 BHK Flats"
      },
      {
        "id": "possessionDate",
        "value": "Possession: Sep, 2024"
      }
    ]
  }, // ... Many other property details
] 
```

The scraper returns comprehensive property data in a structured format, with each property record containing the following fields:

**Property Identification:**

- **ID**: Unique identifier for the property listing on Housing.com
- **URL**: Direct link to the full property details page
- **Name**: Official property or project name as listed
- **Subtitle**: Additional descriptive information or tagline

**Visual and Location Data:**

- **Image URL**: Primary property image for visual identification
- **Polygons Hash**: Geographic boundary data for precise location mapping
- **Address**: Complete property address including area and locality details
- **Coordinates**: Latitude and longitude for mapping and proximity analysis

**Property Characteristics:**

- **Current Possession Status**: Indicates ready-to-move, under-construction, or future possession
- **Is Active Property**: Boolean flag showing current listing status
- **Is Most Contacted**: Popularity indicator based on user inquiries
- **Features**: Array of property amenities and characteristics (parking, gym, swimming pool, etc.)

**Pricing Information:**

- **Min Price**: Starting price range for the property
- **Max Price**: Maximum price range for different units
- **Currency**: Pricing currency (typically INR for Indian properties)
- **Price Display Value**: Formatted price string as shown on the website

**Marketing and Seller Data:**

- **Posted Date**: When the listing was published or last updated
- **Promotions**: Current promotional offers or discounts
- **Custom Offers**: Special deals specific to the property
- **Suggested Offers**: Platform-recommended offers
- **Seller**: Information about the listing agent or property developer

**Additional Property Information:**

- **Property Information**: Detailed specifications including size, type, and configuration

This comprehensive output structure enables users to conduct thorough market analysis, price comparison, and property evaluation across different locations and property types.

### Usage Guide

**Step 1: URL Preparation**\
Identify the Housing.com search result pages you want to scrape. Navigate to Housing.com, perform your desired search (by location, price range, property type), and copy the resulting URLs. Include multiple pages if you need extensive data coverage.

**Step 2: Configuration Setup**\
Configure the JSON input with appropriate retry limits and proxy settings. For Indian properties, select "IN" as the proxy country. Set reasonable limits for items per URL to balance thoroughness with performance.

**Step 3: Data Extraction**\
Execute the scraper with your configured input. The tool will systematically process each URL, extract property data, and compile results into the structured output format.

**Best Practices:**

- Use residential proxies to maintain consistent access
- Implement reasonable delays between requests to avoid overloading the server
- Regularly update your URL list as new properties become available
- Monitor extraction quality and adjust retry parameters as needed

**Common Issues and Solutions:**

- If encountering access restrictions, verify proxy configuration and country settings
- For incomplete data extraction, increase retry limits or check URL validity
- Handle rate limiting by implementing longer delays between requests

### Benefits and Applications

The Housing.com Property Search Scraper delivers significant time savings by automating what would otherwise require manual data collection across hundreds or thousands of property listings. This efficiency enables real estate professionals to focus on analysis and decision-making rather than data gathering.

**Practical Applications:**
Real estate market analysis becomes more comprehensive with access to large-scale property data. Investment firms can identify emerging market trends, compare pricing across different locations, and assess property value propositions. Market researchers can track housing supply, analyze price movements, and generate insights for industry reports.

The structured data output facilitates integration with existing business intelligence tools and databases, enabling automated reporting and analytics workflows that drive informed business decisions.

### Conclusion

The Housing.com Property Search Scraper transforms property data collection from a manual, time-intensive process into an efficient, automated workflow. By providing comprehensive, structured access to Housing.com's extensive property database, this tool empowers real estate professionals and researchers to make data-driven decisions with confidence.

Ready to streamline your property research? Start extracting valuable insights from Housing.com's vast property database today.

## Related Actors

- [**Housing.com Property Details Page Scraper**](https://apify.com/ecomscrape/housing-property-page-details-scraper): Your comprehensive tool for extracting valuable property information from Housing.com's extensive real estate platform.

## Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Housing.com Property Search Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Property list page urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `max_items_per_url` (type: `integer`):

Limit the number of items per URL you want to scrape

## `max_retries_per_url` (type: `integer`):

Limit the number of retries for each URL if the scrape is detected as a bot or the page fails to load

## `proxy` (type: `object`):

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://housing.com/in/buy/projects/goregaon_east?page=3"
  ],
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://housing.com/in/buy/projects/goregaon_east?page=3"
    ],
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/housing-property-search-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://housing.com/in/buy/projects/goregaon_east?page=3"],
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/housing-property-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://housing.com/in/buy/projects/goregaon_east?page=3"
  ],
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}' |
apify call ecomscrape/housing-property-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ecomscrape/housing-property-search-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/2r88Kn1xhj9HiIvR8/builds/y0ONIA5Orgy30KhCL/openapi.json
